Reviews from Yandex Maps, Yandex.Medicine, and 2GIS

The review feed no longer creates duplicate pages in search results.

Fixes

Yandex and Google indexed the review page many times: separately for each pagination page, each doctor in the panel, and each sorting option (address formats like /reviews/?xlr_grid_...=page-2, ?xlr_doctor=..., ?xlr_sort=...). Now, switching pages, doctors, and sorting works as before without reloading the page, but such addresses no longer appear in links or the browser's address bar. Search engines see and index only one page—the one where the feed is displayed.

Pagination pages and doctor cards remain selectable via the keyboard using the Tab and Enter keys.

What changes for visitors

The page address does not change when switching feed pages, doctors, or sorting. After reloading the page, the feed opens again on the first page with the default sorting.

Compatibility

If you have copied the "Grid" or "List" component template to your site template and modified it, pagination links and the doctor panel in your copy will remain unchanged, and duplicates will continue to appear. Apply the changes from the module template to your copy.

Addresses already indexed by search engines will not disappear from search results immediately. To speed this up, remove them in Yandex Webmaster and Google Search Console, or add the line Clean-param: xlr_sort&xlr_aspect&xlr_doctor with the review section address to your site's robots.txt file.

On some website templates, the reviews slider (default template) stretched the page content column to tens of thousands of pixels: on mobile devices, the page text and the reviews themselves went off the edge of the screen, and empty blocks were visible instead. Now the slider always occupies the width of its container and does not affect the width of the column.

Changed: environment check moved to a separate 'Diagnostics' tab on the module settings page. The tab contains a description of the check, a 'Check Environment' button, and a report. Previously, the button was located next to the buttons for saving and loading reviews, and the report was displayed above the tabs, pushing the form down.

Import reviews

Fixed: when photo storage on the site was enabled, the full review import ("Load all reviews") previously re-downloaded avatars and photos of already saved reviews. When the upload limit for a single run was reached, it replaced local copies with links to Yandex. Now, already downloaded files remain in place, and photos are re-uploaded only if the author added or removed images.

Fixed: file copies accumulated after previous full imports are now automatically deleted upon updating and after each full import. Only files not referenced by any review are deleted; no entries remain in the site's file database.

Fixed: importing a large organization could be interrupted by the time limit, saving nothing. Now reviews are saved after each page, the organization rating is saved immediately, and the import log is updated after each organization. The time limit for importing from settings has been increased to 5 minutes and will no longer decrease if the server limit is higher.

Fixed: the agent ("only new reviews") could skip fresh Yandex Maps reviews: the first page was fetched in "relevance" order, and the check stopped if no new reviews were found among the first 50. Now the agent fetches reviews by date.

Fixed: reviews about a doctor without a specified clinic are no longer attached to the first organization from settings; the doctor no longer appears in the panel of another clinic.

Yandex.Medicine doctors

Added: if multiple clinics are connected, a clinic can be selected for each doctor for the block in which they are displayed. The selection applies immediately after saving, without re-importing. The "Automatic" option preserves the previous behavior.

Added: for doctors added via the "Find doctors" button, the clinic is assigned automatically—the one on whose card the doctor was found.

Changed: doctor settings have been moved to a separate "Doctors" tab on the module settings page.

Website performance

Fixed: the component checked the table structure and executed service queries to the database on every page view. Now the check is performed only once after installation or update.

Added: indexes in the reviews, organizations, and doctors tables — the feed and import now work faster on sites with a large number of reviews.

Added: the list of doctors for the filter panel is cached together with the feed.

Module removal

Fixed: when removing the module, the copy of the component in /local/components/xlogic/reviews, where the site owner could customize templates, was deleted. Now only the copy in /bitrix/components is deleted.

Fixed: when removing the module along with data, photo and avatar files are deleted via the Bitrix file API, without leaving orphaned records in the database.

Documentation

Fixed: instructions on the "Support" tab have been aligned with the interface: the "Doctors" tab, the names of component buttons and parameters, and the condition for the separate doctor page to function.

Sites in windows-1251 encoding

Fixed: On sites using windows-1251 encoding, the module failed to recognize Yandex's bot protection (captcha): instead of a captcha message, the import returned an empty result. Now captcha is detected regardless of the site encoding.

Fixed: On such sites, during 2GIS import, the organization name could be lost, and during Yandex.Medicine import, the doctor's specialty could be lost. Page header parsing is now independent of the site encoding.

Fixed: On sites using windows-1251 encoding, in doctor cards, the name was not shortened to the format "Surname I. O."

Yandex.Medicine doctors

Added: In the doctor page header, consultation topics are displayed — up to eight most discussed topics, with the number of reviews. Hovering over a topic shows the number of reviews and the share of positive ones. Topics were loaded previously but were not displayed on the site.

Settings

Added: "Check environment" button. It displays PHP and Bitrix kernel versions, site encoding, available PHP extensions, permissions for the /upload folder, status of the import agent and the agent launch method (cron or site requests), proxy settings, and the availability of Yandex.Maps, Yandex.Medicine, and 2GIS from the server. If the hosting IP receives a captcha, the report will indicate this. Settings are not saved during the check. The report is convenient to attach to a support request.

Fix for the settings page error

2GIS import: 2gis.ru/firm/ returns a 301 status with a Location header lacking a scheme (/city/firm/..., //2gis.ru/...), causing the built-in HttpClient of older core versions to fail with the error "Only http and https schemes are supported". Importer2Gis::httpGet() disables automatic redirects and handles them manually (up to 5 hops). Importer2Gis::resolveLocation() parses full, protocol-relative, root-relative, and relative addresses.

The 2GIS import error message includes the HTTP status code and the network error text (Importer2Gis::httpErrorDetail()).

New option import_proxy ("Proxy for import", on the "Settings" tab). Importer::normalizeProxy() validates the format [login:password@]address:port. Importer::applyProxy() configures the proxy for all HTTP clients in the module (Yandex Maps, short links, images, 2GIS, Yandex.Medicine). This is required if the hosting IP receives a Yandex CAPTCHA.

The "Support" tab on sites using windows-1251 displayed ? instead of arrows. In the language file, ? has been replaced with >. In reviews.css and reviews.js, characters outside the windows-1251 set are written as escaped sequences.

Yandex.Medicine Doctors

Fixed: The doctor's photo was not being imported. Now the address is taken from the profile's microdata, and if it is not there, from the og:image of the doctor's page. The address is still checked for allowed hosts of Yandex and 2GIS.

Fixed: The doctor's photo in the header could remain transparent on sites where the theme hides images with loading="lazy". Lazy loading has been disabled for the doctor's photo.

Added: Schema.org Physician microdata for the doctor's page: name, link to the card, specialty, photo, reviews (Review) and AggregateRating. The average rating is calculated based on review ratings, not the percentage of recommendations; the number of reviews is taken from the doctor's card.

Fix for sorting errors

Reviews of doctors from Yandex.Medicine. Connect doctor cards — the module will load their reviews along with specialties, recommendation percentage, and consultation topics.

Doctor panel above the feed: a card with photo, surname, and number of reviews; clicking filters the feed. Works via standard links without JavaScript.

Separate doctor page. The DOCTOR_ID component parameter locks a specific specialist: instead of the organization header, the doctor's card with their feed is displayed.

"Find Doctors" button in module settings: gathers doctors published on cards of connected organizations and offers them as a list — you only need to select the desired ones.

No duplicates on the page. Reviews for a clinic where a doctor is mentioned are also shown by Yandex on the doctor's card: the module marks them and by default does not display them in the doctor's feed. They are enabled via the SHOW_CLINIC_REVIEWS parameter.

The Yandex organizations field accepts links to clinics in Yandex.Medicine of the form [link] — this is the same card as on Yandex.Maps.

Module settings are divided into sections: "Review Sources", "Yandex.Medicine Doctors", and "Import and Storage". The 2GIS key has been moved to the 2GIS organizations field.

The doctor status table in settings shows which organization each doctor is linked to and how many reviews have been loaded.

The "Technical Support" tab includes instructions for doctors: how to obtain a link, how the doctor search works, and what to do if a doctor is not found.

Updates occur without reinstallation: the doctors table and new fields are created automatically; previously loaded reviews and settings are preserved.

Minor cosmetic changes

Added a compact badge

Module security improvement

Added masonry template

### Import from 2GIS

- Separate list of 2GIS organizations in the module settings

- Import via public Reviews API public-api.reviews.2gis.com without a partner key.

- SOURCE field (yandex / 2gis) in company and review tables.

- 2GIS CDN allowlist when saving photos locally.

- In the Support tab - instructions on how to obtain a 2GIS link.

### xlogic:reviews component

- DGIS_COMPANY_ID and MIX_SOURCES parameters - mixed feed of Yandex and 2GIS reviews.

- Symmetrical selection of Yandex and 2GIS organizations: Do not use... or a specific card (without auto-selecting the first from the list).

- Double rating header and separate CTA in mixed mode.

- Source link on the card leads to the corresponding platform.

### Import and database

- During import, the organization's review **topics** (carousel "Food · 91%", "Staff", etc.) are saved in the `ASPECTS` field of the companies table.

- Fields `ASPECT_IDS` and `ASPECT_RANKS` have been added to the reviews table to link to topics during import (preparation for future use).

- Class `ReviewSort`: sorting modes (by date, rating, relevance).

### Component `xlogic:reviews`

- Carousel of **review topics** in the style of Yandex.Maps (display without filtering by topic).

- Dropdown list for **sorting** reviews with AJAX update of the list and pagination.

- Parameter **`SHOW_ASPECTS`** — show or hide review topics.

- Parameter **`SHOW_FILTERS`** — show or hide sorting.

- Design of **review cards** is close to Yandex.Maps: yellow stars, red "Leave a review" button, typography, and spacing.

- Templates `.default`, `list`, `grid` and general styles `reviews.css` have been updated.

In component parameters: number of reviews, sorting by date or rating, minimum rating, filters for 'text only' and 'photo only'.

Configurable agent interval and import log for each organization (success, captcha, number added).

During import, the organization header (rating and number of reviews) is updated even if there are no new reviews.

Schema.org microdata: Review and AggregateRating.

Photos and avatars can be saved as copies on the site or displayed from Yandex servers. If the CDN is unavailable, a placeholder is shown instead of a broken image.

Module settings are organized into tabs: settings, log, technical support (short link, component sample, contacts).