ReviewOps turns your Joomla site into a directory of places with reviews: listings (restaurants, campsites, shops, associations…), ratings per criterion, a search with filters and a map, a space for members and a single moderation queue. Everything is managed from Components › ReviewOps.
The Getting started block of the dashboard repeats these steps and ticks each one off as soon as it is done.
The dashboard sums up the activity of the directory and takes you straight to the work waiting for you.
The administrator module ReviewOps - Dashboard is placed on the home page of the administration at installation: it shows the items waiting and a small activity chart. Its settings (number of items, days shown) are changed in Content › Administrator Modules.
Directory categories are Joomla categories that belong to ReviewOps: create them in Components › ReviewOps › Categories and nest them as usual (Restaurants › Crêperies).
When you edit a category, the ReviewOps tab holds the directory settings:
Title, description, access and language remain those of Joomla: a category restricted to registered users hides its listings from visitors.
A listing type describes a family of places. Open Listing types to create them; drag them to change their order.
Each criterion (Food, Welcome, Value for money…) gets its own stars in the review form. The overall rating is the average of the criteria, weighted by their Weight. A criterion can be Required or switched off. With no criterion at all, visitors give a single overall rating. Three to five criteria keep the form quick to fill in.
Removing a criterion that has already been rated keeps it hidden and recomputes the overall ratings: no rating is lost.
Choose the groups shown by this type and drag them into the order of the page. The same group (for example "Practical") can serve restaurants and campsites alike.
A group makes one block of the listing page. In Fields › Field groups, give it a title and an icon, and choose whether it shows its title. The screen of a group shows its fields (drag them into order) and the types that use it.
The Fields screen lists the fields by group, with their behaviour (required, search filter, comparison…) and the number of listings filled in. Tick several fields, then use Move the checked fields to to change their group.
Available field types:
In choice fields, each choice has a text, a code, an icon, a colour and a tooltip. Paste a list adds several choices at once, one per line (code|Text|#colour, code and colour optional). Renaming the code of a choice updates the listings.
The Live preview shows the field as it will look in the forms and on the listing page. You can change the type of a field that already has values after confirming, but its values may become unreadable.
The Listings screen shows every listing with its photo, rating, reviews, map position and owner. Filters find listings by type, category, state, featured, rating, photos, owner or map position; type id:12 in the search box to find one listing.
The toolbar lets you publish, unpublish, archive or trash, Feature or Remove from featured, Export (CSV) the listings and Compute the notes again.
At the top of the listing, Prefill from the name of the establishment looks the establishment up in OpenStreetMap, anywhere in the world, with no account or key. Type its name and town, then choose it in the list. ReviewOps shows what it found beside what the listing already holds: address and position, phone, e-mail, website, social networks, opening hours, and in France the SIRET with the state of the establishment in the register of companies. Only the ticked lines are copied. Fields already filled in with another value are unticked by default. Check, then save.
The button Search only the French register of companies is for French establishments missing from OpenStreetMap: it uses the name and town of the listing. Visitors who add a place benefit from the search too: choosing the establishment under the name field fills in the empty address and contact details.
The scheduled task ReviewOps – Check the register of companies (France) checks every week that the listings with a SIRET are still open. A closed establishment is shown in the list of listings (filter « Register of companies ») and in the listing. It is marked « closed for good » only if you ask for it in the task.
In the reviews box of the listing, QR code to collect reviews gives a QR code that opens the review form, to print or download (PNG, SVG) for the establishment.
The Listing at a glance panel sums up rating, reviews, photos and views, and lists the reviews to approve. View on the site opens the listing, even when unpublished (a preview only you and the moderators can see).
The Reviews screen gathers visitor reviews and editor reviews. The Current, Pending, Published and Rejected tabs separate what still needs a decision; filters sort by listing, author, rating or photos. Approve, Put on hold and Reject act on the selection.
In a review, you can correct the title, the text, the pros and cons, the date and kind of visit and the rating of each criterion. You can also:
The side panel shows the helpful votes, the origin of the review, the abuse reports received and the Device fingerprint: an irreversible digest of the IP address that spots repeated reviews without keeping the address.
Each publication, rejection or deletion recomputes the rating of the listing, its counters and its ranking score, and tells the author according to their preferences.
The Moderation screen gathers everything that waits for a decision in a single queue, oldest first:
Whenever you reject something, you can write a reason that is sent to the author. Tick several items to Approve the selection or Reject the selection at once. The filters at the top narrow the queue to one kind of item.
J or down arrow: next item; K or up arrow: previous item.A: approve, apply or dismiss; R: reject; H: hide the reported content.X: select; E: open for editing; N: write a reason for the author, then Enter.?: show the list of shortcuts.A review that receives too many abuse reports goes back to moderation until you decide (Options › Reviews › Hide a review after (reports)). Trusted members and groups with the "Publish without moderation" permission are published at once.
The Members screen lists the contributors: reviews, photos, helpful votes, points, last review and status. The figures at the top give the number of members, of members active in the last 30 days, of trusted members and of points earned. Filters sort by activity, trust or account state.
The page of a member shows their public profile (public name, town, presentation, photo), latest reviews, the places they manage and their figures. You can correct the profile, remove the photo, Add or remove points and set the trust.
Points reward contributions: published review, first review of a place, photos, helpful votes received, place added, correction accepted. Their values are set in Options › Reviews. Points move the member up the levels: Newcomer, Explorer, Regular, Connoisseur, Expert, Ambassador.
The Appearance screen sets the look of the directory on the site, with a Live preview that uses the real styles of the site, on desktop, tablet or phone, in light or dark mode.
Back to the preset discards every change. Only the managers of the options can save; other users can look.
The Import screen brings in listings from a spreadsheet (Excel, LibreOffice, Google Sheets) saved as CSV, TSV or TXT: one row per listing.
id column), your own reference or their name; an empty cell leaves the information unchanged.Export the listings produces a CSV filtered by type, category and state, with the separator of your choice; edited and imported again, it updates the listings. The Empty template gives the right headers. The Latest imports list keeps each run with its report and a downloadable journal. Undo this import deletes everything it created; listings that were only updated stay as they are.
Create the pages of the directory in Menus with a ReviewOps menu item:
List pages are set in the menu item: default display (grid of cards, list, or list and map side by side), columns, listings per page, how the next results load, search bar and "Where?" field, filters offered (categories, types, rating, price, open now, photos, featured), sort choice, grid / list and map buttons, introduction, header image and map height. A page can also be limited to one type or to featured listings.
It shows the photo gallery (with a viewer), the overall rating and the ratings per criterion, the description, the details by group, the editor review, the visitor reviews (sortable and filterable by rating or photos), the practical information (address, map, directions, contact details, social networks, hours with "open now") and nearby listings. Quick buttons call, open directions, the website or the e-mail.
Page addresses are readable: /menu/category/subcategory/name-of-the-listing.
The review form asks for a rating per criterion (or one overall rating), a title, the text, pros and cons, date and kind of visit and photos, depending on the settings of the type and of Options › Reviews. There you can limit reviews to one per member and place, stop owners from rating their own place, set a minimum and maximum length, allow editing for a number of days and send edited reviews back to moderation. Reviews from visitors without an account (name and e-mail) are possible and always moderated.
Under each review, readers can vote "helpful", report a problem (spam, offensive, false, conflict of interest, personal information, copied content…) or share the review.
The Add a place form works in steps: category, the essentials, address and contact (with address suggestions and a marker on the map), hours and price, details specific to the category, photos, then review and send. A draft is kept: the member can stop and come back later.
In Options › Submission, choose the open categories, whether a town is required, the number of photos, whether visitors without an account may submit places and whether the author of a place becomes its manager.
On a listing, Suggest a correction lets visitors report wrong information, a place closed for good, or edit the whole listing. Proposals reach moderation as suggestions comparing before and after. Changes made by the owner apply at once when Changes of the managers apply at once is on.
Members keep places in favorite lists, follow a listing or a member to be told about new reviews, add places to the comparison and share a listing or a review (link, e-mail, social networks, or an image ready for stories, created on the visitor's device).
List pages combine a "What are you looking for?" box, a "Where?" field with Around me, filters and sorting. Filters offered: categories and subcategories, kind of place, radius around a place, minimum rating, price level, open now, with photos, featured, and every field marked as Search filter. A single-choice field matches any of the values chosen; a multiple-choice field requires all of them.
Possible sort orders: recommended (matched text, featured and rating), best rated, most reviewed, newest, name, price low to high or high to low, and nearest.
Settings in Options › Search and lists: default order, how the next results load (page links, "Show more" button or automatic on scrolling; page links stay for search engines), counts next to the filters, search in the custom fields, listing suggestions while typing, default radius and radii offered.
Maps show the listings on an OpenStreetMap, OpenStreetMap France or CARTO (soft or dark) background, or on another tile server. In Options › Maps and addresses: default centre and zoom, grouping of close markers, zoom with the mouse wheel, Search this area button when the visitor moves the map, maximum number of markers.
A listing is placed on the map when it is saved, never while a page is displayed. Choose the address service: automatic (API Adresse in France, OpenStreetMap elsewhere), the French IGN API Adresse, Photon or Nominatim. Answers are cached (180 days by default); set the main country and, if needed, restrict addresses to it.
One single module, ReviewOps, offers several displays: latest listings, best rated, featured listings, nearby, latest reviews, map, search form and categories. Its settings:
.sp-page-title for Helix Ultimate), under an adjustable veil that fades while it is used; it moves with the mouse, or with two fingers on a phone. Follow the current page shows the listings of the page displayed (following filters, sort and pages) or the listing opened. Search form: bar, card in a side column or home page banner, "Where?" field, categories, "Around me".The Content - ReviewOps plugin replaces {reviewops …} codes in articles with the same blocks as the module. The first word names the block, then come name=value settings:
{reviewops listing=12}: the card of a listing; {reviewops rating listing=12}: its stars within the text.{reviewops reviews listing=12 count=3}: the latest reviews of a listing (without listing, of the whole directory).{reviewops map cat=3 height=380}: a map of the listings of a category.{reviewops latest cat=3 count=6 layout=list}, {reviewops top}, {reviewops featured}, {reviewops nearby}: lists of listings.{reviewops search style=hero} and {reviewops categories style=chips}: search and categories.Accepted shortcuts: cat (categories, several separated by commas), type, count or limit, layout (grid, list, compact, overlay), cols, min (minimum rating), sort. Yes and no are written yes / no, oui / non or 1 / 0. Values with spaces go between quotes: title="Our favourite places". The plugin settings give the default values of every code.
ReviewOps tells members about what concerns them: review online or rejected, new review on a place they manage, helpful vote received, added place published or declined, correction applied or declined, new review on what they follow. Moderators are told about content waiting and new abuse reports.
Each member chooses in My space › Settings which notifications they receive. The look of the e-mails (colour, logo, footer) is set in Options › Notifications.
E-mails go through a queue: an action on the site never waits for the mail server. Enable the tasks in System › Scheduled Tasks, with the Joomla scheduler or a cron job:
Without the sending task, e-mails stay in the queue.
Each listing page carries its title, meta description, canonical address, Open Graph and Twitter tags, and structured data: kind of place (chosen in the type), address, position, opening hours, price level, average rating, reviews and breadcrumb. Search engines can then show stars in their results. Category pages also get their description and social network previews.
In Options › SEO:
https://your-site/reviewops-sitemap.xml (the name can be changed). Add it to Google Search Console and to robots.txt with a Sitemap: line followed by the address.In each listing, the SEO tab allows a tailored title and description, with a preview. The Smart Search - ReviewOps plugin adds the listings to the search of the whole site, with their custom fields and filters by category, type, town, region and language; index the content once after enabling it.
ReviewOps keeps the data collected to a minimum and helps you answer people's requests:
The User - ReviewOps plugin links the directory to Joomla accounts: a ReviewOps tab in the site profile and in the users of the administration, and handling of deleted accounts. For a deleted account or an erasure request, choose to keep the reviews without identity or to delete the reviews too. Export requests of the Joomla privacy component include the member's ReviewOps data (profile, reviews, photos, favorites, notifications…).
nofollow.In Options › Permissions, besides the usual Joomla rights (administer, manage, create, edit, edit state, delete):
Categories also have their own create, edit and delete permissions.
The options are in Components › ReviewOps › Options (the Options button of the toolbar). Overview of the tabs:
After a significant change (scale, criteria), Listings › Compute the notes again brings every rating up to date at once.