Favorites

¿Por qué favoritos?

Favorites está diseñado para usuarios finales y desarrolladores de temas. Proporciona una API fácil de usar para añadir la funcionalidad del botón favorito a cualquier tipo de entrada.

El plugin puede proporcionar una forma de guardar favoritos, me gusta, marcadores o cualquier otro tipo de datos similar con su texto de botón personalizable.

Visita favoriteposts.com para obtener una lista completa de las funciones de plantilla y los shortcodes disponibles.

Características

Usar con cualquier tipo de publicación: activa o desactiva la funcionalidad favorita por tipo de entrada mientras agrega automáticamente un botón de favorito antes y/o después del contenido. O utiliza las funciones incluidas para mostrar el botón en cualquier lugar de tu plantilla.

Disponible para todos los usuarios: ¿No deseas ocultar la funcionalidad detrás de un acceso? Favoritos incluye una opción para guardar los favoritos de los usuarios anónimos por Sesión o Cookie. Los favoritos de los usuarios que han iniciado sesión también se guardan como meta de usuario

Diseñado para desarrolladores: los favoritos funcionan muy bien para principiantes, pero un conjunto completo de funciones de plantilla desbloquea casi cualquier tipo de funcionalidad personalizada que los desarrolladores puedan necesitar. Favoritos genera la cantidad mínima de marcado necesaria, poniendo el estilo y el control en tus manos.

RGPD

As of version 2.2, a setting is provided to help comply with GDPR standards. To enable this setting, visit Settings > Favorites > Users, and check the field under «User Cookie Consent.» When this setting is enabled, the content saved under the setting displays in a modal window, and the user must agree to the terms you provide before favorite cookies can be saved. Note: There is no language provided by default. This should be supplied by a qualified attorney or legal entity. Once the user has approved or denied cookies, that is saved in the «simplefavorites» cookie along with the timestamp of approval or denial. If the site is part of a multi-site installation, the setting will carry through to all sites.

Si tu sitio ya cuenta con una solución de cumplimiento de cookies, hay dos eventos jQuery a nivel de documento que pueden activarse para aprobar o denegar cookies en segundo plano.

Para aprobar el uso de cookies, activa el evento «favorites-user-consent-approved». Para denegar el uso de cookies, activa el evento «favorites-user-consent-denied».

Compatible con varios sitios: a partir de la versión 1.1.0, Favoritos es compatible con varios sitios. Los favoritos de los usuarios se guardan en un sitio/blog y se pueden recuperar y mostrar en todos los sitios.

Para obtener más información, visita favoriteposts.com.

Importante: Favoritos requiere la versión 3.8 o superior de WordPress y la versión 5.4 o superior de PHP.

Uso

Botón favorito

El botón favorito se puede añadir automáticamente al contenido activando tipos de entradas específicas en los ajustes del plugin. También se puede añadir a los archivos de plantilla o a través del editor de contenido utilizando las funciones o shortcodes incluidos. La identificación de la entrada puede dejarse en blanco en todos los casos si está dentro del bucle. El parámetro de identificación del sitio es opcional, para uso en instalaciones de múltiples sitios (el valor por defecto es el sitio actual).

• Obtener función: get_favorites_button($post_id, $site_id)
• Función de impresión: the_favorites_button($post_id, $site_id)
• Shortcode: [favorite_button post_id="" site_id=""]

Recuento de favoritos (por entrada)

Los favoritos totales de cada entrada se guardan como un número entero simple. Si un usuario desfavorece una entrada este recuento se actualiza. Los favoritos de los usuarios anónimos cuentan para el total de forma predeterminada, pero pueden desactivarse mediante el ajuste del plugin. La identificación de la entrada puede dejarse en blanco en todos los casos si está dentro del ciclo.

• Obtener función: get_favorites_count($post_id)
• Función de impresión: the_favorites_count($post_id)
• Shortcode: [favorite_count post_id=""]

Recuento de favoritos (por usuario) Muestra el número total de favoritos que ha marcado un usuario. Las funciones de plantilla aceptan el mismo parámetro de filtros que las funciones favoritas del usuario.

• Obtener función: get_user_favorites_count($user_id, $site_id, $filters)
• Función de impresión: the_user_favorites_count($user_id, $site_id, $filters)
• Shortcode: [user_favorites user_id="" site_id="" post_types=""]

Favoritos del usuario

Los favoritos del usuario se almacenan como un array de ID de entrada. Los favoritos de los usuarios que han iniciado sesión se almacenan como un metacampo de usuario personalizado, mientras que los favoritos de los usuarios anónimos se almacenan en la sesión o en la cookie del navegador (configurable en los ajustes del plugin). Si se omite el parámetro de identificación de usuario, los favoritos son los predeterminados para el usuario actual. El parámetro de identificación del sitio es opcional, para su uso en instalaciones de varios sitios (por defecto, el sitio actual).

• Obtener función (devuelve un array de ID): get_user_favorites ($ user_id, $ site_id)
• Obtener función (devuelve la lista html): get_user_favorites_list($user_id, $site_id, $include_links, $filters, $include_button, $include_thumbnails = false, $thumbnail_size = 'thumbnail', $include_excerpt = false)
• Función de impresión (imprime una lista html): the_user_favorites_list ($ user_id, $ site_id, $ include_links, $ filtros, $ include_button, $ include_thumbnails = false, $ thumbnail_size = 'miniatura', $ include_excerpt = falso)
• Shortcode (imprime una lista html, con la opción de omitir enlaces): `[user_favorites user_id =» «include_links =» true «site_id =» «include_buttons =» false «post_types =» post «include_thumbnails = «false» thumbnail_size = «thumbnail» include_excerpt = «false»]

Lista de usuarios que han marcado una entrada como favorita

Muestra una lista de usuarios que han marcado como favorito una entrada específica. Si se omite el parámetro de identificación de usuario, los favoritos son los por defecto para el usuario actual. El parámetro de identificación del sitio es opcional, para su uso en instalaciones de varios sitios (por defecto, el sitio actual). La función get devuelve un array de objetos de usuario.

• Obtener función (devuelve un array de objetos de usuario): get_users_who_favorited_post ($ post_id, $ site_id)
• Función de impresión (imprime una lista html): the_users_who_favorited_post ($ post_id = null, $ site_id = null, $ separator = 'list', $ include_anonymous = true, $ anonymous_label = 'Usuarios anónimos' , $ anonymous_label_single = 'Usuario anónimo')
• Shortcode (imprime una lista html): `[post_favorites post_id =» «site_id =» «separator =» list «include_anonymous =» true «anonymous_label =» Usuarios anónimos «anonymous_label_single =» Usuario anónimo «]

Botón vaciar favoritos

Muestra un botón que permite a los usuarios vaciar todos sus favoritos.

• Obtener función: get_clear_favorites_button ($ site_id, $ text)
• Función de impresión: the_clear_favorites_button ($ site_id, $ text)
• Shortcode: `[clear_favorites_button site_id=»» text=»Clear Favorites»]

Recuento de favoritos (en todas las entradas) Muestra el número total de favoritos de un sitio determinado.

• Obtener función: get_total_favorites_count ($ site_id)
• Función de impresión: the_total_favorites_count ($ site_id)