Descripción
¡Hola desarrolladores de temas!
¿Alguna vez has añadido una imagen destacada a una entrada y pensaste, “Me gustaría poder añadir más de una imagen de esta forma”? Bien, ahora ya puedes. Featured Galleries es similar a la funcionalidad de imágenes destacadas de WordPress. La única diferencia es que las entradas obtienen una galería completa en lugar de una sola imagen. Estas galerías se comportan casi exactamente como las imágenes destacadas, y usan el administrador de medios de WordPress. Los usuarios pueden seleccionar imágenes, definir el orden y guardar la galería, todo a través de una sencilla interfaz de arrastrar y soltar.
Nota: Este plugin NO SE ENCARGA DE LA CREACIÓN DE HTML EN LA PARTE PÚBLICA. De esto se deben encargar los temas, para permitir la máxima flexibilidad. Featured Galleries solo se encarga de crear las galerías destacadas y almacenarlas como metadatos en la interfaz de administración. Tendrás que integrar esto en tu tema, o usar un tema que ya integre esta funcionalidad.
Guía de inicio rápido para integrar en temas
Para obtener más información, consulta el wiki de GitHub.
He intentado que esto sea lo más intuitivo posible. Los temas pueden integrar las galerías destacadas de la misma forma que integran las imágenes destacadas. En cualquier plantilla donde quieras que aparezca la galería, el tema tendrá que llamar a la función get_post_gallery_ids()
. Si se usa dentro del loop, la función no necesita ningún parámetro. Por defecto, devolverá un array de identificadores de imagen.
Ejemplo
Incluido dentro del loop. Esto devuelve todas las imágenes de la galería destacada en forma de array y, a continuación, lo recorre para mostrar cada imagen usando una etiqueta HTML <img>
.
$galleryArray = get_post_gallery_ids();
foreach ( $galleryArray as $id ) {
echo '<img src="' . wp_get_attachment_url( $id ) .'">';
}
También puedes personalizar el valor devuelto por la función para que se adapte a tus necesidades. Consulta la documentación completa de la función para más detalles.
Tipos de contenido personalizados
El plugin incluye un filtro para añadir galerías destacadas a tipos de contenido personalizado fácilmente. Consulta la documentación del filtro fg_post_types
para más detalles.
Personalizando el gestor de medios
El gestor de medios se puede personalizar de varias formas. Consulta la documentación de los filtros fg_show_sidebar
y fg_use_legacy_selection
para más detalles.
¿Quieres ayudar?
Me encantaría que alguien me ayudara con la internacionalización. Funcionó durante un tiempo, pero drivingralle escribió ese código porque no controlo este tema realmente, y no estoy seguro de que todavía funcione.
Capturas
Instalación
Hay dos maneras de instalar este plugin.
Manualmente:
- Sube la carpeta
featured-galleries
al directorio/wp-content/plugins/
- Ve al menú “Plugins” de WordPress, busca “Featured Galleries” en la lista y selecciona “Activar”.
A través del repositorio de WP:
- Ve al menú “Plugins” de WordPress, haz clic en el botón “Añadir nuevo”.
- Busca “Featured Galleries”. Haz clic en “Instalar ahora”.
- Vuelve al menú “Plugins” de WordPress, busca “Featured Galleries” en la lista y selecciona “Activar”.
Preguntas frecuentes
- Instrucciones de instalación
-
Hay dos maneras de instalar este plugin.
Manualmente:
- Sube la carpeta
featured-galleries
al directorio/wp-content/plugins/
- Ve al menú “Plugins” de WordPress, busca “Featured Galleries” en la lista y selecciona “Activar”.
A través del repositorio de WP:
- Ve al menú “Plugins” de WordPress, haz clic en el botón “Añadir nuevo”.
- Busca “Featured Galleries”. Haz clic en “Instalar ahora”.
- Vuelve al menú “Plugins” de WordPress, busca “Featured Galleries” en la lista y selecciona “Activar”.
- Sube la carpeta
- ¿Qué sentido tiene esto?
-
Me encargaron actualizar una página de proyectos destacados de una web de un cliente. Los proyectos eran un tipo de contenido personalizado y la página que los mostraba usaba una WP_Query especial. Cada proyecto tenía una imagen destacada. El cliente quería que cada proyecto tuviera varias imágenes que se pudieran visualizar haciendo clic en ellas. No encontré una forma fácil de hacerlo, así que lo desarrollé desde cero. Un amigo me sugirió abstraerlo en un plugin para poderlo compartir.
- ¿Recibirá mejoras?
-
Sí. El siguiente paso en mi hoja de ruta es averiguar cómo cambiar la clave de todos los datos para que empiecen con un guión bajo, para que éstos sean invisibles.
- ¿Puedo añadir una galería destacada a mi tipo de contenido personalizado?
-
¡Sí que puedes! Ni siquiera tienes que editar el plugin para hacerlo. Hay información sobre cómo hacerlo en las instrucciones.
Reseñas
Colaboradores y desarrolladores
Este software es de código abierto. Las siguientes personas han contribuido a este plugin.
Colaboradores“Featured Galleries” ha sido traducido a 7 idiomas locales. Gracias a los traductores por sus contribuciones.
Traduce “Featured Galleries” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
2.1.0
- Enhancement: Switched multi-select type from Library to Gallery. You no longer have to hold the SHIFT or CONTROL/COMMAND keys to select multiple items. To restore the old behavior, use the new
fg_use_legacy_selection
filter. See docs for details. - Bugfix: Fix broken details sidebar hiding filter. The details sidebar is now properly hidden again by default, and can be shown be using the
fg_show_sidebar
filter. - Under the Hood: Complete rewrite of all CSS styles. FG styles are now isolated and don’t affect other media manager modals.
2.0.1
- Bugfix: Don’t run plugin logic on old versions of PHP that are incompatible.
2.0.0
- Under the Hood: Complete rewrite top to bottom of all PHP and Javascript.
- Enhancement: Improved admin preview styles to show more thumbnails in less space.
- Enhancement: Added documentation for public API function into Readme.
- Enhancement: Improved Readme examples.
- Enhancement: Added No-JS fallback.
- Enhancement: Add compatibility with the picu plugin.
- Bugfix: Primary buttons in Media Manager now have proper labels again.
- Change: Bumped WordPress Version Requirement to 3.8.
- Change: Bumped PHP Version Requirement to 5.4.
1.7.1
- Added missing stylesheet to hide sidebar.
1.7.0
- Added filter to allow themes to show the sidebar in the media manager instance created by Featured Galleries (Sidebar is hidden by default).
1.6.0
- Improved CSS styling of the backend gallery inside the metabox. Metabox is now more responsive, per request.
1.5.0
- Accidentally put the version of 1.4.5 when I meant to use 1.4.4, but in change log used correct version. This bump to 1.5 restores consistency.
1.4.4
- Tested with WP 4.4 and bumped up compatibility.
1.4.3
- Bugfix: If
get_post_gallery_ids()
was called on post with empty Featured Gallery, using an array return (the default), an array containing one string (a comma) was returned instead of an empty array.
1.4.2
- Bugfix: Undefined variable
$oldfix
when running post-MP6 versions of WordPress (3.9 and over). Props Joshuadnelson. - WordPress 4.2 compatibility bump.
1.4.1
- Updating readme to add example code for custom post types.
1.4.0
- WordPress 4.1 compatibility bump.
- Bugfix: Margin difference between buttons on left and right in media model.
- Bugfix: Button type and text change didn’t fire when Media model defaults to upload instead of to media library.
1.3.1
- Fixed issue where the scripts required to open the Media Manager might notbe enqueued.
1.3.0
- Added internationalization and German translation. Props to Drivingralle.
- Formatting fixes to better match WordPress PHP best practices. Props Drivingralle.
1.2.4
- Fixes a typo in the readme.txt file.
1.2.3
- As reported in suppor thread, error messages were being thrown in WP DEBUG mode, when trying to save things unrelated to plugin. Fixes those errors.
1.2.2
- More bug fixes for 3.9 and 3.5 – 3.7, to bring everything into line visually in all versions that use the media manager.
1.2.1
- Bugfix, CSS background positioning missing on delete images icons in WP 3.5 – 3.7.
1.2.0
- Added compatibility for WordPress 3.9 (Had to rearrange the javascript slightly).
- Improved compatibility for WordPress 3.5 – 3.7 by using built in icon images instead of Dashicons in those versions.
1.1.6
- Fixed inconsistent Markup.
1.1.5
- Overhauled readme.txt to include implementation instructions and examples.
1.1.4
- Slight bug was introduced in 1.1.3, get_post_gallery_ids() won’t work.
1.1.3
- Added a new argument to get_post_gallery_ids(), allowing it to return only the first image in the gallery.
1.1.2
- Minor bug fix update. If used opened, closed, and then reopened the gallery selector, the back button would appear incorrectly. Skipping 1.1.1 because that is a silly version number.
1.1.0
- Completely screwed up commits for 1.0.0 and 1.0.1, and copied the entire folder instead of trunk. Fixed now.
1.0.1
- Minor update, fixed a CSS bug where buttons were incorrectly small on mobile (< 783px) screens.
1.0.0
- First public version. Added support for WP’s Preview Changes functionality. Accomplished this be using two pieces of metadata.
0.9.0
- Initial test version sent to WP for submission.