Favorites v2.3.6

Почему Избранное?

Избранное предназначено для конечных пользователей и разработчиков тем. Он предоставляет простой в использовании API для добавления функций избранных кнопок к любому типу сообщений.

Плагин может предоставить возможность сохранять избранное, лайки, закладки или любые другие подобные типы данных с помощью настраиваемого текста кнопки.

Посетите сайт Favoriteposts.com, чтобы получить полный список доступных функций шаблона и шорткодов.

Особенности

Использовать с любым типом сообщения. Включите или отключите функцию избранного для каждого типа сообщения, автоматически добавляя кнопку избранного до и/или после контента. Или используйте встроенные функции, чтобы отобразить кнопку в любом месте вашего шаблона.

Доступно для всех пользователей. Не хотите скрывать функциональность за логином? Избранное включает в себя возможность сохранять избранное анонимных пользователей с помощью сеанса или файла cookie. Избранное пользователей, вошедших в систему, также сохраняется в виде метаданных пользователя.

Создано для разработчиков. Избранное отлично работает для новичков, но полный набор функций шаблона открывает практически любые пользовательские функции, которые могут понадобиться разработчикам. Избранное выводит минимально необходимое количество разметки, предоставляя стиль и контроль в ваши руки.

GDPR

Начиная с версии 2.2, предусмотрена настройка, помогающая соответствовать стандартам GDPR. Чтобы включить этот параметр, перейдите в "Настройки" > "Избранное" > "Пользователи" и установите флажок в разделе "Согласие пользователя на использование файлов cookie". Если этот параметр включен, содержимое, сохраненное с помощью этого параметра, отображается в модальном окне, и пользователь должен согласиться с предоставленными вами условиями, прежде чем любимые файлы cookie смогут быть сохранены. Примечание. По умолчанию язык не указан. Его должен предоставить квалифицированный адвокат или юридическое лицо. Как только пользователь одобрил или отклонил файлы cookie, это сохраняется в файле cookie "simplefavorites" вместе с отметкой времени одобрения или отклонения. Если сайт является частью установки на нескольких сайтах, настройка будет распространяться на все сайты.

Если на вашем сайте уже имеется решение по соблюдению требований к файлам cookie, есть два события jQuery на уровне документа, которые могут быть запущены для одобрения или отклонения файлов cookie в фоновом режиме.

Чтобы одобрить использование файлов cookie, инициируйте событие "избранное-согласие-пользователя-одобрено". Чтобы запретить использование файлов cookie, инициируйте событие "избранное-пользователь-согласие-отказано".

Совместимость с несколькими сайтами. Начиная с версии 1.1.0, "Избранное" совместимо с несколькими сайтами. Избранное пользователя сохраняется для каждого сайта/блога и может быть получено и отображено на разных сайтах.

Для получения дополнительной информации посетите сайт Favoriteposts.com.

Важно: для избранного требуется WordPress версии 3.8 или выше и PHP версии 5.4 или выше.

Использование

Кнопка избранного

Кнопку избранного можно автоматически добавить к контенту, включив определенные типы сообщений в настройках плагина. Его также можно добавить в файлы шаблонов или через редактор контента, используя включенные функции или короткие коды. Идентификатор сообщения можно оставить пустым во всех случаях, если он находится внутри цикла. Параметр идентификатора сайта является необязательным и предназначен для использования в многосайтовых установках (по умолчанию используется текущий сайт).

- Функция получения: get_favorites_button($post_id, $site_id)

- Функция печати: the_favorites_button($post_id, $site_id).

- Шорткод: [favorite_button post_id="" site_id=""]

Любимый граф (по почте)

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

- Функция получения: get_favorites_count($post_id)

- Функция печати: the_favorites_count($post_id)

- Шорткод: [favorite_count post_id=""]

Любимый счетчик (по пользователю)

Отображает общее количество избранных, добавленных пользователем. Функции шаблона принимают тот же параметр фильтров, что и функции избранного пользователя.

- Функция получения: get_user_favorites_count($user_id, $site_id, $filters)

- Функция печати: the_user_favorites_count($user_id, $site_id, $filters)

- Шорткод: [user_favorites user_id="" site_id="" post_types=""]

Избранное пользователя

Избранное пользователей хранится в виде массива идентификаторов сообщений. Избранное пользователей, вошедших в систему, хранится в виде настраиваемого метаполя пользователя, а избранное анонимных пользователей хранится либо в файле cookie сеанса, либо в файле cookie браузера (настраивается в настройках плагина). Если параметр идентификатора пользователя опущен, в избранном по умолчанию используется текущий пользователь. Параметр идентификатора сайта является необязательным и предназначен для использования в многосайтовых установках (по умолчанию используется текущий сайт).

- Функция Get (возвращает массив идентификаторов): get_user_favorites($user_id, $site_id)

- Функция Get (возвращает список HTML): get_user_favorites_list($user_id, $site_id, $include_links, $filters, $include_button, $include_thumbnails = false, $thumbnail_size = "thumbnail", $include_excerpt = false)

- Функция печати (печатает список html): the_user_favorites_list($user_id, $site_id, $include_links, $filters, $include_button, $include_thumbnails = false, $thumbnail_size = "thumbnail", $include_excerpt = false)

- Шорткод (печатает список в формате HTML с возможностью пропуска ссылок): `[user_favorites us