FacetWP Alphabetical Listing - Плагин WordPress

Руководство по настройке FacetWP Alphabetical Listing для алфавитной навигации

FacetWP Alphabetical Listing нужен не для обычной сортировки записей, а для быстрого отбора элементов по первой букве выбранного поля. В этом руководстве разберём, как подготовить данные, создать A-Z facet, вывести его рядом со списком FacetWP, проверить индексацию и не спутать алфавитный фильтр с сортировкой по названию.

Материал рассчитан на сайт, где уже есть FacetWP или планируется связка FacetWP + листинг: каталог специалистов, база брендов, словарь терминов, каталог документов, витрина товаров, список локаций или любой другой набор записей, который удобно просматривать по буквам. Сначала мы пройдём базовую установку и первичную проверку, затем подробно настроим источник данных, подписи, порядок вывода, сценарий с Listing Builder и диагностику типичных ошибок.

Главная мысль простая: A-Z Listing хорошо работает только тогда, когда поле, по которому строится буква, совпадает с логикой вывода списка. Если буквы берутся из заголовка, список должен быть отсортирован по заголовку. Если буквы берутся из поля фамилии, список тоже должен быть отсортирован по этому полю. Иначе пользователь нажмёт букву, увидит правильный набор результатов, но сама страница будет казаться хаотичной.

Что делает A-Z Listing и где он действительно полезен

Алфавитная навигация кажется простой: на странице есть строка A, B, C, D и так далее, пользователь нажимает букву, список сокращается до записей, начинающихся с этой буквы. В FacetWP Alphabetical Listing за этой простотой стоит обычная логика FacetWP: аддон добавляет отдельный тип фасета, FacetWP индексирует значения выбранного источника данных, а затем Ajax-обновлением показывает только релевантные записи.

Это не замена поиску и не замена Sort facet. Поиск отвечает на вопрос "есть ли в записи такая строка", сортировка меняет порядок уже найденных записей, а A-Z Listing отсекает записи по первой букве поля. Поэтому лучший результат получается на страницах, где посетитель заранее понимает, как устроен список: фамилии авторов, названия брендов, термины справочника, города, производители, документы, услуги, имена участников каталога.

Плагин особенно уместен в трёх случаях. Первый - длинный каталог, где обычные категории слишком грубые, а полнотекстовый поиск заставляет пользователя угадывать точное слово. Второй - справочная база, где человек хочет быстро перейти к букве, как в бумажном указателе. Третий - связка с другими фасетами FacetWP: буква сначала сужает список, а чекбоксы, выпадающие списки или диапазоны уточняют результат.

Кому подойдёт такой тип фильтра

FacetWP Alphabetical Listing удобно ставить на страницы, где важна предсказуемость. Если у вас каталог врачей, алфавит по фамилии понятнее, чем набор случайных специализаций. Если вы ведёте базу брендов, буква помогает быстро найти производителя без прокрутки. Если на сайте есть глоссарий, A-Z Listing превращает длинную страницу терминов в управляемый справочник.

Ещё один хороший сценарий - каталоги на пользовательских типах записей WordPress. Например, тип записи company хранит компании, поле brand_name хранит публичное название, а таксономии описывают отрасль и регион. В этом случае A-Z Listing может фильтровать по brand_name, а остальные фасеты уточняют отрасль и регион. Такой подход полезнее, чем отдельные страницы под каждую букву, потому что пользователь остаётся в одном интерфейсе и может комбинировать условия.

Когда лучше выбрать другой инструмент

Алфавитная навигация не поможет, если записи не имеют понятного первого символа. Для магазина с товарами, где покупатель выбирает цену, размер и наличие, буква в названии чаще вторична. Для блога, где материалы ищут по теме, дате или автору, A-Z Listing может выглядеть искусственно. Для базы с коротким набором из десяти записей он тоже избыточен: проще показать весь список или добавить обычный поиск.

Есть и языковое ограничение. По умолчанию A-Z Listing работает с латинским диапазоном A to Z и отдельным символом # для значений, которые начинаются с цифр. Документация FacetWP описывает хуки для добавления других символов, но это уже техническая настройка, после которой требуется повторная индексация. Если каталог полностью русскоязычный и нужен алфавит А-Я, нужно заранее оценить, готовы ли вы сопровождать этот код и проверять индексацию после изменений.

Как FacetWP Alphabetical Listing определяет первую букву

Ключевая настройка A-Z Listing - Data source. Она определяет, из какого атрибута записи, таксономии или пользовательского поля FacetWP берёт значение для вычисления первой буквы. Если источником выбран заголовок записи, FacetWP смотрит на начало заголовка. Если выбран custom field, логика строится вокруг значения этого поля. Именно поэтому настройку источника нельзя делать "примерно": от неё зависит и набор букв, и поведение фильтра, и то, какие записи появятся после клика.

В официальной документации FacetWP указано, что при стандартной логике буквы показываются в латинском диапазоне A to Z. Перед индексацией первый символ упрощается через встроенную функцию WordPress remove_accents(): акценты снимаются, верхний и нижний регистр приводятся к сопоставимому виду. Поэтому записи, начинающиеся с обычной N и с символов вроде Ñ, при базовой настройке могут попадать в одну буквенную группу. Это удобно для англоязычного каталога, но требует внимания для языков, где акцентированная буква должна считаться отдельной.

Отдельный символ # работает как группа для чисел. Если значение в выбранном источнике начинается с цифры, такая запись попадает в эту группу. Для каталога моделей, документов или артикулов это полезно. Для справочника имён, где числовые записи не ожидаются, # можно убрать через подтверждённый документацией hook. Главное - после изменения набора символов выполнить повторную индексацию, иначе интерфейс и индекс могут говорить на разных языках.

Почему буква и порядок списка должны совпадать

Самая частая методическая ошибка - поставить A-Z facet, но оставить листинг отсортированным по дате публикации. Технически фильтр может работать: при нажатии B он покажет записи, чей выбранный источник начинается с B. Но внутри результата записи будут лежать в порядке дат, и пользователь не увидит привычного алфавитного списка. Для каталога это выглядит как баг, хотя фильтр отработал правильно.

Поэтому для алфавитной страницы лучше заранее выбрать поле сортировки. Если фильтр берёт букву из заголовка, стартовый запрос Listing Builder или ваш WP_Query должен сортировать по заголовку по возрастанию. Если фильтр берёт букву из поля last_name, сортировка должна идти по этому же полю или по связанной паре полей, если это оправдано структурой данных. При использовании Listing Builder это настраивается в Query tab через query sort. В кастомном шаблоне порядок задаётся аргументами запроса WordPress.

Что происходит после клика по букве

FacetWP добавляет выбранное значение в URL как query variable, обновляет фасеты и листинг через Ajax и сохраняет состояние страницы. Это важно для практики: пользователь может скопировать ссылку с выбранной буквой, а кнопка "назад" в браузере обычно возвращает состояние фильтра. Поэтому не стоит отключать query string без веской причины. Документация FacetWP прямо предупреждает, что отключение query variables лишает пользователя возможности передавать и восстанавливать выбранные фасеты по URL.

С точки зрения SEO A-Z Listing не должен превращаться в генератор сотен индексируемых дублей. FacetWP работает с параметрами URL, и это нормальная модель для динамической фильтрации. Если нужна отдельная SEO-страница под каждую букву, лучше проектировать её отдельно, а не пытаться сделать из Ajax-фасета структуру постоянных страниц. Для большинства каталогов задача A-Z Listing - удобство поиска внутри уже существующей страницы, а не создание новых посадочных URL.

Что проверить перед установкой и включением аддона

Перед установкой стоит убедиться, что сайт готов именно к FacetWP-сценарию. Сам A-Z Listing является add-on facet type, поэтому он не решает задачи базового FacetWP: не создаёт сам листинг, не исправляет неправильные запросы темы и не подготавливает поля. Если основная страница уже плохо фильтруется другими фасетами, алфавитный аддон добавит ещё один симптом, а не устранит причину.

Начните с структуры данных. Выпишите, по какому полю посетитель ожидает алфавит: заголовок записи, фамилия, название бренда, название города, термин, артикул, название документа. Затем проверьте первые символы в реальных записях. Часто в базе встречаются технические префиксы, пробелы, кавычки, цифры, скрытые символы, HTML-сущности или приставки вроде "The". Если пользователь ожидает искать "The North Face" по N, а значение хранится как "The North Face", базовая логика первой буквы отдаст его в T. Это не ошибка FacetWP, а вопрос нормализации данных.

• Проверьте, установлен и работает основной FacetWP, потому что A-Z Listing является дополнением к нему.
• Определите листинг, который будет фильтроваться: Listing Builder, архив WordPress, кастомный WP_Query, поддерживаемый page builder или другой подтверждённый шаблон.
• Выберите источник данных для первой буквы и убедитесь, что в нём нет случайных пустых значений.
• Проверьте, какая сортировка нужна по умолчанию, чтобы выбранная буква выглядела логично.
• Подготовьте тестовую страницу или staging-копию, если сайт уже посещаемый.
• Запланируйте повторную индексацию после создания фасета и после изменения hooks, влияющих на символы.

Проверка совместимости с темой и конструктором

FacetWP умеет работать с разными типами листингов, но для корректного обновления он должен понять, какой запрос на странице является основным фильтруемым списком. На страницах с page builder, несколькими loops, каруселями, виджетами похожих записей и рекламными блоками может быть несколько запросов. Официальный troubleshooting FacetWP указывает, что при неверном определении query результаты могут выглядеть правильно при первой загрузке, но ломаться после фильтрации.

Если вы используете Elementor, Bricks, Beaver Builder или другую систему вывода, сначала проверьте общую документацию FacetWP по этому типу листинга. Особенно внимательно относитесь к кешированию элементов: для Elementor Element Caching официально указан как несовместимый в проблемных FacetWP-сценариях, а для Bricks в troubleshooting упоминается отключение кеширования query loops. Для A-Z Listing это не особая настройка, но именно такие конфликты часто выглядят как "буквы не работают".

Проверка индексации до настройки внешнего вида

Не начинайте с дизайна строки букв. Сначала убедитесь, что FacetWP может индексировать выбранный источник данных. В настройках FacetWP есть действия для повторной индексации и проверки indexable post types. Если нужный тип записи не индексируется, A-Z Listing не сможет показать корректные варианты. Если выбранное поле хранит сериализованные данные, relationship-структуры или сложные значения, может потребоваться отдельная настройка индексации, но для обычного заголовка или простого текстового custom field это обычно не нужно.

Практическое правило: сначала создайте минимальный A-Z facet на тестовом листинге, нажмите несколько букв и проверьте результат. Только после этого добавляйте CSS, кастомные символы, заголовки букв внутри списка и дополнительные фасеты.

Установка и первичная проверка в WordPress

FacetWP Alphabetical Listing устанавливается как дополнение к FacetWP. Официальная страница add-ons указывает, что add-ons загружаются из аккаунта при активной лицензии. В этом руководстве не рассматривается покупка, ввод license key или обход активации: мы говорим о настройке уже доступного установочного файла и его применении на сайте.

Общий порядок для WordPress стандартный. В админ-панели откройте Plugins, добавьте ZIP-файл аддона, установите его и включите. После включения перейдите в настройки FacetWP и проверьте, появился ли новый тип фасета A-Z Listing при создании нового facet. Если тип не появился, сначала проверьте, активен ли основной FacetWP, затем убедитесь, что загружен именно add-on для A-Z Listing, а не другой пакет.

Минимальный тест после активации

Создайте временный фасет с понятным названием, например az_title. В поле Data source выберите заголовок записи или другой простой источник, где точно есть значения. Значение Default label можно оставить стандартным или заменить на короткое "Все", если интерфейс страницы русскоязычный. После сохранения выполните повторную индексацию.

Затем выведите фасет рядом с тестовым листингом. Если используете блоковый редактор, можно вставить shortcode FacetWP в блок Shortcode. Для PHP-шаблона используется функция вывода FacetWP, но в обычном руководстве для владельца сайта безопаснее начать с shortcode, потому что его проще удалить и откатить без правки темы.

[facetwp facet="az_title"]
[facetwp template="directory_listing"]

После публикации тестовой страницы нажмите на букву, для которой точно есть записи. Правильный результат: URL получает параметр FacetWP, выбранная буква визуально активна, листинг обновляется без полной перезагрузки страницы, а повторный клик по той же букве или выбор Any сбрасывает фильтр. Если результаты исчезли или страница показывает не тот список, переходите к разделу диагностики, а не меняйте внешний вид.

Как безопасно откатить тест

Откат простой: удалите shortcode с тестовой страницы, отключите временный фасет или оставьте его неиспользуемым, если он не мешает рабочему интерфейсу. Если вы добавляли hooks для символов, уберите код из child theme или code snippets plugin и снова выполните индексацию. Не удаляйте основной FacetWP и не очищайте рабочие настройки, пока не поймёте, что проблема относится именно к A-Z Listing.

Подробная настройка фасета: Data Source, Default Label и вывод на странице

После первичного теста можно настраивать рабочий фасет. В отличие от многих фильтров, у A-Z Listing мало видимых параметров: источник данных и подпись сброса. Но именно эти два параметра определяют, будет ли интерфейс понятным. Дополнительная сложность появляется не в форме фасета, а вокруг неё: в сортировке листинга, индексировании, переводе строки, совместимости с другими фасетами и поведении на мобильных экранах.

Выбор Data Source

Для каталога имён чаще всего выбирают заголовок записи или отдельное поле фамилии. Для брендов - поле названия бренда. Для документов - название документа или индексный код, если именно код нужен пользователю. Для товаров WooCommerce можно использовать заголовок продукта, но стоит подумать, действительно ли покупатель ищет товар по первой букве. Если каталог огромный и брендоцентричный, буква уместна. Если покупатель выбирает характеристики, A-Z лучше оставить дополнительным инструментом.

Хороший источник данных должен быть стабильным. Если редакторы часто меняют заголовки, а публичный каталог должен сортироваться по официальному названию, лучше создать отдельное custom field и использовать его как источник. Если в базе встречаются пустые поля, такие записи не смогут корректно участвовать в буквенной навигации. Если в поле лежит HTML или составная строка, стоит очистить данные на уровне контента или индексации, а не пытаться закрыть проблему CSS.

Типовой выбор для разных каталогов

Default Label и перевод строки сброса

Default label меняет стандартную подпись Any, через которую пользователь возвращается к полному списку. Для русскоязычной страницы лучше использовать короткое "Все", "Любая буква" или "Сбросить букву". Выбор зависит от дизайна. Если строка букв компактная, "Все" занимает меньше места. Если интерфейс обучающий и рядом нет Reset facet, "Любая буква" понятнее.

Документация FacetWP указывает, что Default label для A-Z Listing можно переводить через facetwp_i18n. Это важно для сайтов с WPML или Polylang, где не все динамические строки FacetWP видны обычному механизму перевода. Если сайт одноязычный, чаще достаточно задать русскую подпись прямо в настройке. Если сайт многоязычный, не смешивайте языки в одном фасете: английская версия должна иметь свой текст, русская - свой.

Где разместить A-Z facet на странице

Алфавитный фильтр лучше размещать над листингом или сразу перед ним. В боковой колонке A-Z может превратиться в длинную сетку и потерять смысл. Пользователь ожидает видеть буквы как горизонтальную навигацию, похожую на указатель. Если на странице есть поиск, категории и A-Z, логичный порядок обычно такой: поисковая строка, затем алфавит, затем уточняющие фильтры или наоборот, если главная задача - категории. Главное - не прятать буквы ниже списка, иначе человек начнёт прокручивать и не поймёт, что фильтрация есть.

В Listing Builder вывод можно собрать shortcode-парой: сначала фасет, затем template. В PHP-шаблоне можно вывести фасет и листинг функциями FacetWP. В page builder используйте родные виджеты или shortcode-модули, если они поддерживаются вашей связкой. После каждого изменения проверяйте не только визуальный вид, но и URL, активную букву, сброс, пагинацию и работу вместе с другими фасетами.

Сортировка листинга в Query tab

Если вы используете FacetWP Listing Builder, откройте Query tab и задайте сортировку, которая соответствует Data source. Для заголовка записи это Post Title по возрастанию. Для custom field нужно использовать подходящий источник и тип сравнения, если он доступен в вашей конфигурации. Документация Listing Builder объясняет, что можно добавлять несколько query sort правил: первое задаёт основной порядок, следующие работают как дополнительный порядок при одинаковых значениях.

Минимальная проверка после настройки сортировки: откройте страницу без выбранной буквы и убедитесь, что записи идут ожидаемо. Затем выберите букву, у которой много результатов, и проверьте порядок внутри выбранной группы. Если порядок правильный без фильтра, но ломается после клика, возможно, FacetWP фильтрует не тот query или на странице есть конфликт с кешем, page builder или кастомным запросом.

Как сочетать алфавит с поиском, категориями и пагинацией

На реальной странице A-Z Listing редко живёт в одиночестве. Обычно рядом есть текстовый поиск, категория, регион, тип записи, сортировка, пагинация или кнопка сброса. Хорошая настройка состоит не в том, чтобы добавить как можно больше фасетов, а в том, чтобы каждый из них отвечал на отдельный вопрос пользователя. Буква отвечает на вопрос "с чего начинается нужная запись", поиск отвечает на вопрос "какое слово есть внутри", категории отвечают на вопрос "к какому разделу относится запись", а Sort facet отвечает на вопрос "в каком порядке смотреть уже найденные элементы".

Если эти роли перемешать, интерфейс становится тяжёлым. Например, строка букв, поиск, выпадающий список категорий, сортировка и пагинация могут работать технически правильно, но пользователь не поймёт, с чего начать. Для справочника терминов логично поставить A-Z выше поиска: человек сначала выбирает букву, затем при необходимости уточняет термин. Для каталога компаний можно сначала дать поиск и отрасль, а алфавит сделать вторым рядом. Для WooCommerce-витрины алфавит часто лучше размещать после основных товарных фильтров, потому что покупатель чаще мыслит категориями и свойствами, чем первой буквой названия.

Буква + поиск

Сочетание A-Z Listing и Search facet хорошо работает в глоссариях, библиотеках, каталогах документов и справочниках имён. Но важно объяснить пользователю, что эти условия складываются. Если выбрана буква B, а в поиске введено слово, которого нет среди записей на B, результат будет пустым. Это нормальная логика FacetWP, но она может выглядеть как ошибка, если на странице нет явной подсказки о выбранных фильтрах или Reset facet.

Практическая проверка такая: выберите букву, где много записей, введите слово, которое точно есть среди них, затем введите слово, которого среди них нет. В первом случае список должен сузиться, во втором - показать no results state. Если после очистки поиска буква остаётся выбранной, значит состояние фасетов работает ожидаемо. Если очистка одного поля сбрасывает всё, проверьте, не добавлен ли кастомный JavaScript или сторонний поиск, который вмешивается в URL FacetWP.

Буква + категория или таксономия

Для каталогов записей часто нужна связка "буква + раздел". Например, база знаний может иметь разделы "Payments", "Security", "Content", а внутри каждого раздела пользователи ищут термины по буквам. В таком сценарии A-Z Listing берёт первую букву из заголовка термина, а категория сужает область. Важно проверить, что при выбранной категории строка букв не вводит в заблуждение. FacetWP обычно показывает релевантные choices с учётом результата, но поведение зависит от типа фасета, источника данных и настроек.

Если выбранная категория резко сужает список, часть букв может стать неактивной или вести к пустым комбинациям. Это не обязательно плохо. Плохо, если пользователь не видит, какие условия уже выбраны. Поэтому на сложных страницах полезен User Selections facet или понятная область активных фильтров. Если вы не хотите добавлять отдельный блок выбранных условий, хотя бы сделайте активную букву визуально заметной и не прячьте кнопку сброса.

Буква + пагинация

Пагинация особенно важна для A-Z Listing, потому что выбранная буква может возвращать десятки или сотни записей. Если список без выбранной буквы разбит на страницы, проверьте, что после выбора буквы пользователь попадает на корректную первую страницу результата, а не остаётся на старой странице, где подходящих записей уже нет. FacetWP Pager facet создан именно для работы внутри системы FacetWP, поэтому он предпочтительнее случайной пагинации темы на динамической странице с фасетами.

Проверьте сценарий: откройте третью страницу каталога, выберите букву с небольшим числом записей, затем сбросьте букву и снова выберите другую. Если URL и pager ведут себя предсказуемо, связка работает. Если появляются пустые страницы, проверьте, не оставляет ли кастомный шаблон старый параметр пагинации и не конфликтует ли нативная пагинация темы с FacetWP Pager.

Буква + Sort facet

Sort facet не должен спорить с A-Z Listing. Если пользователь выбрал букву M, а затем сортировку "newest first", он получит записи на M, но в порядке дат. Это может быть оправдано в каталоге новостей или документов, где человек хочет сначала выбрать букву, а потом увидеть самые свежие материалы. В справочнике имён это обычно сбивает. Поэтому не добавляйте варианты сортировки просто потому, что они есть в FacetWP. Оставляйте только те варианты, которые соответствуют смыслу каталога.

Если сортировка по умолчанию уже A-Z, а A-Z Listing отвечает за выбор буквы, дополнительный Sort facet может быть нужен только для обратного порядка Z-A или по дате обновления. В этом случае подписи должны быть ясными: "Название A-Z", "Название Z-A", "Сначала новые". Не называйте Sort option "A-Z filter", потому что это смешивает сортировку и фильтрацию.

Редакторская подготовка данных для стабильного алфавитного каталога

Техническая настройка FacetWP Alphabetical Listing занимает меньше времени, чем подготовка данных. Если редакторы годами вводили названия вручную, в базе могут быть пробелы в начале, разные варианты написания, артикулы перед названием, кавычки, HTML-фрагменты, сокращения, приставки и дубли. A-Z Listing честно использует выбранный источник данных, но он не исправляет смысловую неаккуратность контента. Поэтому перед запуском полезно сделать маленький редакционный аудит.

Начните с десяти-двадцати записей на разные буквы. Откройте каждую запись и посмотрите, какое поле должно быть источником алфавита. Если заголовок содержит "Dr. Jane Miller", а пользователь ищет врача по фамилии Miller, заголовок не подходит. Если бренд хранится как "123 Acme", а публично пользователи ожидают "Acme", нужно решить, что важнее: реальное начало строки или удобство поиска. Иногда правильный ответ - завести отдельное поле alphabet_key или sort_name, которое будет использоваться только для навигации и сортировки.

Нормализация без сложного кода

Не всегда нужен hook. Часто достаточно навести порядок в контенте. Уберите случайные пробелы в начале, согласуйте написание приставок, вынесите служебные коды в отдельное поле, не начинайте публичное название с внутреннего ID, если пользователи его не знают. Если запись должна отображаться как "The Studio", но сортироваться по Studio, можно хранить публичный заголовок отдельно, а источник A-Z и sort key - отдельно. Это требует дисциплины при редактировании, зато делает поведение каталога понятным.

Для больших каталогов удобно добавить короткую инструкцию для редакторов: какое поле заполнять, какие символы не ставить в начале, как поступать с цифрами, что делать с брендами на других языках, когда запускать повторную индексацию или просить администратора её выполнить. Такая инструкция не относится к коду FacetWP, но именно она предотвращает большинство "мистических" буквенных ошибок через месяц после запуска.

Контрольные записи для тестирования

Создайте несколько тестовых записей, которые не публикуются в основном каталоге или используются на staging: простая латиница, запись на цифру, запись с акцентом, запись с нижним регистром, запись с пустым полем, запись с приставкой. После каждой важной настройки проверяйте их. Это особенно полезно, если вы добавляете дополнительные символы через hooks или меняете источник данных. Контрольные записи быстро показывают, где проблема: в индексе, в источнике, в сортировке или в ожидании пользователя.

Мини-итог: A-Z Listing лучше всего раскрывается там, где редакционная логика данных заранее совпадает с интерфейсом. Если в базе хаос, алфавитный фильтр не скроет его, а сделает заметнее.

Практический пример: каталог специалистов с буквами по фамилии

Представим сайт образовательного центра, где есть каталог преподавателей. У каждого преподавателя есть запись типа teacher, заголовок хранит полное имя, а отдельное поле last_name хранит фамилию. Посетителю удобнее искать преподавателя по фамилии, поэтому A-Z Listing должен брать первую букву из last_name, а карточки должны сортироваться по тому же полю.

Цель

Нужно получить страницу, где сверху есть строка букв, ниже - карточки преподавателей. При клике по букве M остаются преподаватели, чья фамилия начинается на M. Если пользователь нажимает "Все", каталог возвращается к полному алфавитному списку. Дополнительные фасеты, например направление обучения или формат занятий, могут работать рядом с буквой и уточнять результат.

Подготовка

Сначала убедитесь, что у всех записей заполнено поле last_name. Если часть преподавателей хранится без фамилии или с пробелом в начале, FacetWP не сможет корректно распределить их по буквам. Затем создайте Listing Builder template для типа записи teacher. В Query tab выберите этот post type, задайте достаточное количество записей на страницу и добавьте сортировку по полю фамилии. Если в вашей реализации проще сортировать по заголовку, тогда источник A-Z тоже должен быть заголовком, иначе возникнет разрыв между фильтром и порядком вывода.

Шаги настройки

1. Создайте новый facet в настройках FacetWP и назовите его понятно, например "Фамилия".
2. Оставьте техническое имя коротким латиницей, например teacher_last_name, потому что имя фасета используется в shortcode, URL и JavaScript.
3. Выберите тип A-Z Listing и укажите Data source, который соответствует полю last_name.
4. Замените Default label на "Все", если страница русскоязычная.
5. Сохраните facet и выполните повторную индексацию.
6. Выведите на странице shortcode фасета над shortcode листинга.
7. Откройте страницу в обычном браузере, нажмите букву, где есть несколько преподавателей, и проверьте карточки.

Проверка результата

Результат считается корректным, если буквы без записей не вводят пользователя в заблуждение, активная буква визуально отличается, URL меняется после клика, карточки остаются в алфавитном порядке, а другие фасеты продолжают уточнять тот же список. Обязательно проверьте сброс: повторный клик по активной букве или выбор "Все" должен вернуть полный набор карточек без перезагрузки всей страницы.

Ещё одна проверка - ссылка с выбранной буквой. Скопируйте URL после клика по букве, откройте его в новой вкладке и посмотрите, восстановилась ли выбранная буква и тот же набор результатов. Если состояние не восстановилось, проверьте, не отключали ли вы query variables и не вмешивается ли кеширование страницы в Ajax-ответ FacetWP.

Нюанс с составными именами и префиксами

Если в каталоге есть фамилии с приставками, дефисами или разными языками, заранее решите редакционное правило. Например, "van Dijk" может искаться по V или D в зависимости от принятой логики. FacetWP не знает вашего справочного стандарта, он берёт первый символ источника данных. Поэтому лучше нормализовать именно поле last_name, чем ждать, что фасет угадает культурные правила сортировки.

Другие алфавиты, цифры и специальные символы

A-Z Listing по умолчанию ориентирован на стандартный латинский алфавит. Для многих англоязычных каталогов этого достаточно. Но сайты часто используют испанские, французские, немецкие, скандинавские, славянские или смешанные наборы символов. Официальная документация FacetWP описывает hook facetwp_alpha_chars, который позволяет заменить, удалить или расширить набор символов фасета. В той же логике используется hook facetwp_alpha_remove_accents, если нужно изменить поведение снятия акцентов.

Не добавляйте другие алфавиты наугад. Если вы просто добавите букву, но оставите снятие акцентов, часть символов может индексироваться не так, как вы ожидаете. Документация приводит пример, где для символов вроде Ñ важно отключить стандартное снятие акцентов, иначе записи могут попасть в группу N. После любого изменения набора символов нужно повторно индексировать данные.

Безопасный пример расширения набора символов

Ниже пример для сайта, где конкретный A-Z facet должен показывать дополнительные символы. Его нужно применять только если вы понимаете, какой фасет меняете, и готовы проверить результат на тестовых записях. Код размещают в child theme, Custom Hooks add-on или надёжном code snippets plugin. Замените my_az_facet_name на техническое имя вашего A-Z фасета.

// Важно: после добавления или изменения кода выполните Re-index в FacetWP.
add_filter( 'facetwp_alpha_chars', function( $chars, $params ) {
    if ( 'my_az_facet_name' === $params['facet']['name'] ) {
        $chars = array(
            '#', 'Æ', 'A', 'B', 'C', 'D', 'E', 'F', 'G',
            'H', 'I', 'J', 'K', 'L', 'M', 'N', 'Ñ', 'O',
            'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X',
            'Y', 'Z'
        );
    }

    return $chars;
}, 10, 2 );

add_filter( 'facetwp_alpha_remove_accents', '__return_false' );

Проверяйте не только наличие новых букв в интерфейсе, но и фактические результаты. Создайте или найдите записи, которые начинаются с добавленных символов, выполните индексацию, нажмите соответствующую букву, затем откройте прямой URL с выбранным фасетом. Если буква появилась, но результатов нет, это может быть не ошибка CSS, а несовпадение между символами в интерфейсе и значениями, сохранёнными в индексе.

Когда лучше убрать символ #

Группа # полезна для каталогов, где записи действительно начинаются с цифр: модели оборудования, коды документов, бренды с числами, артикулы. Но в каталоге людей или терминов она может выглядеть лишней. Документация A-Z Listing разрешает убрать или заменить этот символ через hook. Смысловой критерий простой: если пользователь не ожидает искать записи по цифре, уберите # или сделайте подпись понятнее. Если записи с цифрами есть, не скрывайте их без альтернативного способа найти эти элементы.

Русский алфавит и осторожная формулировка

Для полностью русскоязычного каталога может понадобиться набор А-Я. Официальная документация показывает общий механизм замены символов, но конкретная реализация русского алфавита зависит от того, как у вас хранятся строки, как работает нормализация, какие символы нужны для Ё, и не смешан ли каталог с латиницей. Поэтому в рабочем проекте лучше сначала сделать маленький тестовый фасет на нескольких записях, проверить буквы А, Б, Ё, Я и только потом переносить настройку на большой каталог.

Если нет подтверждённого теста на ваших данных, не обещайте пользователям "полную поддержку любого алфавита". Формулируйте задачу точнее: A-Z Listing можно расширять через hooks, но корректность зависит от набора символов, индексации и источника данных.

Заголовки букв внутри самого листинга

Строка букв сверху решает задачу фильтрации, но иногда хочется добавить буквенные разделители внутри полного списка: A, затем записи на A, B, затем записи на B. Документация FacetWP описывает такой сценарий для Listing Builder в Dev mode и подчёркивает важное условие: поле, по которому выводится буквенный заголовок, должно совпадать с сортировкой запроса и с логикой A-Z facet.

Этот приём полезен для страниц, где пользователь сначала видит полный справочник, а алфавитная строка сверху работает как быстрый фильтр. В полном списке буквенные заголовки помогают визуально сканировать длинную выдачу. Но когда пользователь уже выбрал одну букву, заголовок этой же буквы внутри списка может стать лишним. В официальном примере FacetWP предлагает скрывать такие letter headings, если A-Z facet активен.

Как применять этот подход без лишнего риска

Если вы не используете Dev mode или кастомный шаблон, не нужно насильно добавлять буквенные заголовки. Сначала оцените, нужен ли этот слой интерфейса. Для каталога из 30 записей он избыточен. Для справочника на сотни элементов - полезен. Для карточной сетки с несколькими колонками заголовки должны занимать всю ширину grid, иначе они сломают ритм карточек.

Безопасный CSS для уже существующих буквенных заголовков можно держать отдельно от PHP-логики. Например, если ваш шаблон выводит div с классом letter-heading, можно добавить оформление в CSS-файл child theme или через Customizer, если тема это поддерживает. Это не меняет данные и легко откатывается.

.letter-heading {
    display: block;
    grid-column: 1 / -1;
    margin: 16px 0 8px;
    padding: 10px 16px;
    font-size: 18px;
    font-weight: 700;
    line-height: 1.4;
    color: #ffffff;
    background: #6233ca;
}

Проверка после такого CSS простая: откройте полный список, убедитесь, что заголовки не перекрывают карточки, не создают пустые строки и не ломают мобильный вид. Затем выберите букву в A-Z facet и проверьте, что интерфейс не дублирует очевидную информацию. Если после фильтрации остался один заголовок над одной группой, это не критическая ошибка, но часто визуально шумит.

Проверка результата: что должно работать после настройки

После настройки не ограничивайтесь кликом по первой попавшейся букве. A-Z Listing зависит от индекса, источника данных, сортировки, активного query и поведения Ajax. Поэтому проверка должна идти по цепочке: данные, индекс, интерфейс, URL, сочетание с другими фасетами, мобильная версия и откат. Такая проверка занимает меньше времени, чем последующая диагностика на рабочем сайте.

Мини-чек после каждого изменения

• Откройте страницу без выбранных фасетов и проверьте полный порядок списка.
• Нажмите букву, для которой точно есть несколько записей.
• Проверьте, что активная буква выделена, а URL содержит параметр FacetWP.
• Нажмите другую букву и убедитесь, что старый выбор заменился новым.
• Сбросьте выбор через Any, "Все" или Reset facet.
• Скопируйте URL с выбранной буквой и откройте его в новой вкладке.
• Проверьте работу на мобильной ширине: строка букв не должна перекрывать карточки или уходить за экран без понятной прокрутки.
• Если рядом есть другие фасеты, проверьте комбинацию: буква + категория, буква + поиск, буква + сортировка.

Как понять, что проблема в данных, а не в плагине

Если буква отсутствует, хотя вы уверены, что есть подходящая запись, посмотрите на реальное начало значения в выбранном Data source. Запись может начинаться с пробела, цифры, невидимого символа, HTML-сущности, кавычки или приставки. Если листинг сортируется не по тому полю, пользователь может ожидать одну букву, а индекс честно использовать другую. Для проверки создайте тестовую запись с простым названием вроде "Alpha Test", выполните индексацию и проверьте букву A. Если тестовая запись работает, проблема почти наверняка в исходных данных или выбранном поле.

Как проверить связку с другими фасетами

FacetWP-фасеты aware of each other: выборы должны показываться с учётом текущего результата. На практике это значит, что после выбора буквы другие фасеты могут изменить доступные варианты, а некоторые выборы могут привести к пустой выдаче. Это нормальное поведение, если комбинация действительно невозможна. Но если любая комбинация с A-Z приводит к пустому списку, проверьте query detection, индексацию и структуру HTML страницы.

Скорость, кеш, SEO и удобство интерфейса

A-Z Listing кажется лёгким, потому что визуально это всего строка букв. Но он работает внутри общей системы FacetWP: данные индексируются, запросы обновляются через Ajax, URL хранит состояние, а тема или builder выводит результат. Поэтому на больших каталогах важно не только создать фасет, но и убрать факторы, которые мешают FacetWP обновлять правильный список.

Официальная документация FacetWP по производительности объясняет, что скорость зависит от объёма индексируемого контента, количества фасетов, источников данных, серверной конфигурации и сложности шаблона. Для A-Z Listing это особенно заметно при больших справочниках, где буква стоит рядом с поиском, категориями, сортировкой, пагинацией и карточками с большим количеством динамических полей.

Кеширование и Ajax-обновления

FacetWP troubleshooting отдельно выделяет проблемы с object caching и некоторыми настройками хостинга. Симптомы могут быть разными: список не обновляется, появляются неожиданные записи, пагинация показывает неверные числа, FacetWP не может auto-detect listing. Если такие проблемы возникают именно после клика по букве, не спешите менять A-Z facet. Проверьте, не кешируется ли страница или Ajax-ответ, нет ли object cache на проблемной странице, и не включены ли builder-настройки, которые кешируют query loop.

Для пользовательского опыта полезно добавить Reset facet, если на странице много фильтров. Сам A-Z Listing умеет сбрасываться через активную букву или Any, но когда рядом есть категории, поиск и сортировка, отдельная кнопка сброса делает интерфейс понятнее. При этом Reset facet - отдельный built-in facet type FacetWP, а не часть A-Z Listing.

SEO-логика без переусложнения

Алфавитные фильтры помогают людям, но не должны становиться источником дублей и хаотичных URL. FacetWP использует query variables, потому что это удобно для восстановления состояния и передачи ссылки. Не нужно обещать, что каждая выбранная буква станет отдельной SEO-страницей. Если нужен индексируемый глоссарий по буквам, проектируйте отдельные статические или серверные страницы. Если нужна удобная навигация внутри каталога, A-Z Listing справляется в своей роли.

Доступность и мобильный вид

Проверьте размер кликабельных букв. На десктопе строка A-Z легко помещается в одну линию, но на телефоне символы могут стать слишком мелкими. Хорошая практика - дать буквам достаточно отступов, включить перенос или горизонтальную прокрутку с видимым контекстом, а активной букве дать заметное состояние. Не делайте цвет единственным признаком выбора: добавьте фон, подчёркивание, жирность или другой визуальный сигнал.

Если строка букв расположена над карточками, проверьте, что после Ajax-обновления пользователь не теряет контекст. На длинных страницах иногда уместна прокрутка к началу результатов после выбора фасета, но добавлять JavaScript ради этого нужно осторожно и только по документации FacetWP. Для начала оцените обычное поведение: возможно, короткий каталог и так обновляется в видимой области.

Когда FacetWP Alphabetical Listing будет удачным выбором

FacetWP Alphabetical Listing стоит использовать, если на сайте уже есть или планируется FacetWP-каталог, а посетителям нужен быстрый вход в длинный список по первой букве. Это особенно хорошо работает для справочников, каталогов специалистов, брендов, терминов, документов и других коллекций, где алфавитная логика естественна для пользователя.

Перед запуском проверьте четыре вещи: источник данных совпадает с ожиданием пользователя, листинг отсортирован по той же логике, после настройки выполнена индексация, а страница не конфликтует с query detection и кешем. Если эти условия соблюдены, A-Z Listing даёт понятный и лёгкий интерфейс без создания отдельных страниц под каждую букву.

Если вы готовы проверить аддон на своём каталоге, после чтения руководства можно перейти к скачиванию FacetWP Alphabetical Listing, установить его на тестовой странице и пройти минимальный сценарий: создать A-Z facet, выбрать Data source, выполнить Re-index, вывести shortcode и проверить несколько букв с реальными записями. Такой порядок безопаснее, чем сразу править рабочую страницу с большим набором фильтров.