aicc_conf_apikpixabay(),
'q' => rawurlencode( $keywords ),
'lang' => substr( $idioma, 0, 2 ),
'orientation' => 'horizontal',
'min_width' => '1024',
'min_height' => '512',
'safesearch' => 'true',
'order' => 'popular',
'pretty' => 'false', // Temporalmente true para desarrollo.
);
$pixabay_url = add_query_arg( $query_args, 'https://pixabay.com/api/' );
return $pixabay_url;
}
/** Reformatea las keywords de la maetaetiqueta a algo buscable separado por símbolos "|".
*
* @param string $metakeywords Lista obtenida de las meta Keywords, que es separada por comas.
* @return string con la cadena buscable.
*/
function aicc_forma_keywords_busqueda_pixabay( $metakeywords ) {
// Elimina los espacios en blanco al principio y al final del string.
$metakeywords = trim( $metakeywords );
// Divide el string en un array de palabras clave utilizando comas como separador.
$keywords_array = explode( ',', $metakeywords );
// Itera sobre el array de palabras clave y elimina los espacios sobrantes.
$keywords_array = array_map( 'trim', $keywords_array );
// Une las palabras clave con el símbolo "|" como concatenador.
$formatted_keywords = implode( '|', $keywords_array );
return $formatted_keywords;
}
/** Gestiona la búsqueda de imagen para un artículo y claves dadas.
* Requerirá también $consulta, $idioma para localizar en la caché la imagen
*
* @param string $id Artículo.
* @param string $keywords Búsqueda.
*/
function aicc_seleccionar_imagen( $id, $keywords ) {
$idioma = aicc_conf_idioma();
$cantidad = aicc_conf_pixabay_cantidad();
echo '' . esc_html( __( 'Featured image selection', 'ai-content-creator' ) ) . "
\n";
echo '';
esc_html_e( 'Use the search engine to view images and select one or select', 'ai-content-creator' );
echo ' ';
esc_html_e( 'Without image', 'ai-content-creator' );
echo '';
echo ".
\n";
echo '\n";
echo "
\n";
echo "
\n";
// Muestra la selección de imágenes.
if ( $keywords ) {
aicc_mostrar_miniaturas_pixabay( $id, $keywords, $idioma, $cantidad );
}
}
/** Muestra las miniaturas de imágenes de Pixabay.
*
* @param string $id Artículo.
* @param string $consulta Texto de la consulta enviada.
* @param string $idioma Idioma en que hacer la consulta.
* @param integer $cantidad Máximo de imágenes obtenidas por cada consulta.
* @return array con las respuestas de Pixabay o un error.
*/
function aicc_mostrar_miniaturas_pixabay( $id, $consulta, $idioma, $cantidad = 25 ) {
// Obtiene los resultados de la búsqueda en Pixabay.
$resultados = aicc_busqueda_pixabay( $consulta, $idioma );
// Si hay un error, muestra un mensaje y termina la función.
if ( isset( $resultados['error'] ) ) {
echo '' . esc_html( $resultados['message'] ) . '
';
return;
}
// Muestra las miniaturas de las imágenes.
echo '' . "\n";
// Agrega un elemento "Sin imagen" al comienzo de la lista.
aicc_mostrar_miniatura_pixabay( $id );
$contador = 0;
// La cantidad de imágenes máxima se puede obtener de count( $resultados['hits'] ).
foreach ( $resultados['hits'] as $imagen ) {
// Si se alcanza la cantidad predeterminada de miniaturas, detiene el bucle.
if ( $contador >= $cantidad ) {
break;
}
// Muestra la miniatura y el formulario para seleccionar la imagen.
aicc_mostrar_miniatura_pixabay( $id, $imagen['tags'], $imagen['previewURL'], $imagen['largeImageURL'] );
$contador++;
}
echo "
\n";
// Incluir mención a que las imágenes provienen de Pixabay.
echo '' . esc_html( __( 'Images provided by', 'ai-content-creator' ) ) . ' Pixabay.
';
}
/**
* Muestra una miniatura de la imagen de Pixabay junto con un botón de selección.
*
* La función genera la estructura HTML necesaria para mostrar la miniatura de la imagen de Pixabay,
* así como un botón de selección para elegir la imagen como imagen destacada en un artículo.
* Si no se proporcionan las URL de la imagen y la miniatura, se mostrará un mensaje de error o un mensaje
* que indica que no hay imagen.
*
* @param string $id ID de la imagen de Pixabay.
* @param string $tags Etiquetas asociadas a la imagen, se utilizarán como atributo 'alt' y 'title'.
* @param string $url_miniatura URL de la miniatura de la imagen.
* @param string $url_imagen URL de la imagen en tamaño completo.
*/
function aicc_mostrar_miniatura_pixabay( $id, $tags = '', $url_miniatura = '', $url_imagen = '' ) {
echo ' ' . "\n";
// Si falta solo una de las dos URL, es que algo anda mal con la imagen.
if ( ( '' === $url_miniatura ) ^ ( '' === $url_imagen ) ) {
echo '
' . "\n";
echo '
' . esc_html( __( 'Image failed', 'ai-content-creator' ) ) . "
\n";
echo "
\n";
} else {
// Muestra la imagen o un cartel de "Sin imagen" en función de si se ha indcado URL o no.
if ( $url_miniatura ) {
echo '
 . ' "' . esc_attr( $tags ) . '")
\n";
} else {
echo '
' . "\n";
echo '
' . esc_html( __( 'Without image', 'ai-content-creator' ) ) . "
\n";
echo "
\n";
}
echo '
\n";
}
echo "