ACE Color Extractor

Tabla de Contenidos

1. Introducción
2. Instalación
3. Uso
   3.1 Utilizando una función
   3.2 Utilizando un shortcode
4. Dimensiones de la paleta
5. Preguntas Frecuentes
6. Soporte
7. Hoja de ruta

Introducción

ACE Color Extractor es un plugin de WordPress que te permite extraer los colores más utilizados de una imagen destacada, convertirlo en una paleta de colores y mostrarlo en tu sitio web. También proporciona la opción de descargar la paleta de colores como un archivo SVG.

Instalación

Para instalar el plugin ACE Color Extractor, sigue estos pasos:

• Descarga el archivo ZIP del plugin desde su repositorio oficial.
• Inicia sesión en el panel de administración de WordPress.
• Navega a la sección “Plugins”.
• Haz clic en “Añadir nuevo”.
• Haz clic en “Subir plugin” y selecciona el archivo ZIP que descargaste.
• Haz clic en “Instalar ahora” y luego en “Activar plugin”.

Uso

Puedes utilizar la funcionalidad del plugin ACE Color Extractor de dos maneras: utilizando una función específica, o utilizando un shortcode para mostrar la paleta de colores en lugares predeterminados de tu contenido. A continuación, te explicaremos ambas opciones.

Utilizando una función

Para extraer colores de imágenes y mostrarlos en tus entradas, puedes utilizar la función extract_and_display_color_palette(). Puedes integrar esta función en un archivo de plantilla, como un archivo de entrada (single.php) o un archivo de página (page.php). También funciona como tipos de entrada personalizados (custom post types).

Supongamos que deseas mostrar la paleta de colores en una entrada de blog o página personalizada. Debes asegurarte de que tu plantilla tenga una imagen destacada configurada, ya que la función utiliza esta imagen para extraer los colores.

<?php
// Verifica si existe la función para extraer y mostrar colores.
if( function_exists('extract_and_display_color_palette')) {
	$color_palette = extract_and_display_color_palette('');
	// Muestra la paleta de colores
	echo $color_palette;
} else {
	// do nothing
}
?>

Si la función extract_and_display_color_palette() no está disponible (por ejemplo, si el plugin no está activo), no se mostrará contenido adicional. Esto garantiza que no se muestre nada si la función no existe en la instalación de WordPress. Asegúrate de ajustar el código de acuerdo a tu estructura de plantilla y necesidades específicas.

Utilizando un shortcode

También puedes utilizar un shortcode para mostrar la paleta de colores en cualquier entrada o página. Agrega el siguiente código a tu contenido utilizando un bloque de shortcode:

[ace_palette]

Personalización

Extracción de Colores

Puedes personalizar el proceso de extracción desde el menú de opciones en Ajustes > ACE Color Extractor.

Colores máximos de la paleta: Esta opción controla el número máximo de colores que se extraerán de una imagen y se mostrarán en la paleta.

Umbral de similitud de color: Esta opción controla el umbral de similitud de colores al extraer colores representativos de una imagen.

Esto se representa en forma de porcentaje, donde 0% mostrará una mayor cantidad de colores similares (múltiples tonos de rojo, por ejemplo), mientras que valores más cercanos al 100% agrupará una mayor cantidad de colores similares en un solo bloque de color.

Estilos

Crea y sube tu propia hoja de estilos, utiliza un plugin como Simple Custom CSS and JS o agrega tus propios estilos desde el menú en Apariencia > Personalizar > CSS adiconal para modificar la apariencia de la paleta de colores. Las clases principales que se usan son:

• ace-color-palette-wrapper: El envoltorio de la paleta de colores y enlace de descarga.
• ace-color-palette: La paleta de colores.
• ace-color-square: Los cuadros individuales de cada color.
• svg-download-link: El enlace de descarga.

De esta forma puedes, por ejemplo, cambiar los cuadros de colores individuales a círculos utilizando el siguiente código CSS:

.ace-color-square {
    border-radius: 50%;
}

Preguntas Frecuentes

¿Cómo cambio el número de colores en la paleta?

Puedes controlar el número de colores mostrados en la paleta desde el menú de opciones en Ajustes > ACE Color Extractor.

¿Cómo puedo personalizar el umbral de similitud de colores?

El umbral de similitud se define desde el menú de opciones en Ajustes > ACE Color Extractor.

¿Especifiqué que quería cinco colores y la paleta me muestra solo tres colores?

El número de colores que puedes especificar es una cantidad máxima. El número de colores que terminará mostrando en pantalla corresponderá al porcentaje que especifiques en el umbral de similitud. Mientras más alto sea el porcentaje, habrá menor probabilidad que muestre colores similares. Baja el umbral de similitud para que te muestre más variedad de colores.

¿Puedo utilizar este plugin con cualquier tema?

El plugin ACE Color Extractor está diseñado para funcionar con la mayoría de los temas de WordPress. Sin embargo, es posible que debas ajustar el CSS para que coincida con el estilo de tu tema.

Soporte

Esta documentación proporciona una descripción general del plugin de ACE Color Extractor y su uso. Si quieres modificar o adaptar este plugin, consulta los comentarios del código en el repositorio o abre una solicitud de soporte con el desarrollador del plugin.

Si encuentras algún problema o tienes preguntas adicionales sobre el uso del plugin, no dudes en contactar al desarrollador del plugin.

Hoja de ruta

Puede revisar la hoja de ruta actualizada en este enlace.

Mejora de la interfaz de usuario (UI)

Prioridad: Alta
Descripción: Crear una página de opciones dentro del panel de administración de WordPress que permita a los usuarios configurar los ajustes del plugin y personalizar la apariencia de la paleta de colores.

Parcialmente mejorado en la versión 1.2.0.

Proveer formatos para herramientas de diseño

Prioridad: Media
Descripción: Agregar la capacidad de exportar paletas de colores en formatos CSS y JSON, permitiendo a los usuarios importar fácilmente las paletas en herramientas de diseño como Figma y similares.

Posibilidad de modificar opciones de extracción de forma individual

Prioridad: Media
Descripción: Agregar la opción dentro de cada entrada o página para modificar las opciones de extracción individualmente. Para aquellos casos en que una entrada individual requiera una opción de extracción diferente a la establecida globalmente.

Internacionalización (i18n)

Prioridad: Media
Descripción: Agregar soporte para otros idiomas al hacer que el plugin sea traducible y proporcionar archivos de idioma para la localización.

Implementado en la versión 1.1.1.

Documentación y soporte

Prioridad: Baja
Descripción: Crear un tutorial en vídeo para guiar a los usuarios en el uso e implementación efectiva del plugin.