Skip to content
Heiko Lübbe edited this page Dec 20, 2023 · 13 revisions

Módulo Joomla zitat-service.de 🇪🇸

El módulo Joomla muestra una cita aleatoria de la colección de la comunidad de usuarios www.zitat-service.de. La selección de citas puede limitarse a uno de los cinco idiomas, uno de los más de 500 autores, una de las más de 500 categorías, o las citas establecidas por los propios usuarios. Estamos en línea desde 2007, de forma gratuita y sin publicidad.

NOTA Existe un sitio demo Joomla 5 para el módulo: joomla.zitat-service.de

Instalación

El módulo Joomla zitat-service.de es compatible con las versiones 3, 4 y 5 de Joomla. El módulo se puede instalar en el backend de Joomla como administrador a través de Instalar extensiones:

Configuración

Configuración Básica

Como con cualquier módulo Joomla recién instalado, es necesaria una configuración inicial para que el módulo sea visible. Como administrador de Joomla, vaya a Sistema | Módulos del sitio | zitat-service.de:

  1. Posición: por ejemplo, Sidebar-Right.
  2. Estado: Publicado
  3. Asignación del menú: (normalmente) En todas las páginas.

Tip

Las notas breves en los campos de entrada se muestran con Alternar la ayuda interna.

Parámetros del Módulo

Con las opciones básicas del módulo, es posible limitar las citas mostradas a:

  • un Autor específico (por ejemplo, Goethe),
  • una Categoría (por ejemplo, Fútbol), o
  • un Usuario.

Aquí, los usuarios son los nombres de usuario de los miembros que crearon las citas. Esto le permite seleccionar las citas que usted mismo ha creado, por ejemplo.

La selección * representa a todos los autores, todas las categorías y todos los usuarios.

Hay tres opciones fundamentales para el idioma de la cita:

  • Español - como ejemplo de un idioma específico.
  • frontend - para citas en el idioma utilizado por Joomla. Si un idioma no está soportado, se utiliza el inglés.
  • all - para mostrar las citas en todos los idiomas.

Parámetros avanzados del módulo

La pestaña Avanzado proporciona opciones de personalización adicionales.

Se enlazan las citas y, si están disponibles, también el autor y la fuente. Estos enlaces se abren en la misma ventana/pestaña del navegador. Para que los enlaces se abran en una ventana/pestaña diferente del navegador, debe introducirse un nombre como quote_links en Destino para Enlaces HTML.

El Método de consulta establece cómo se obtiene la cita. El método de consulta recomendado es Asíncrono con JavaScript en el navegador web. Este método obtiene la cita en paralelo con la carga de la página, acelerando así el proceso de carga de la página. Por el contrario, con el método de consulta Desde Joomla, el presupuesto se obtiene junto con la carga de la página. La ventaja de este método es que permite incrustar el módulo varias veces en una página.

Dado que el método de consulta asíncrono obtiene la cita después de que la página ya se ha cargado, los módulos posteriores podrían saltar. Por lo tanto, el módulo debe ser el último de una serie (para dejar espacio debajo) o mantener un espacio horizontal reservado. La altura mínima del módulo puede especificarse con el parámetro Altura (CSS). La altura mínima puede establecerse, por ejemplo, en 20ex o 200px. La categoría WebDesignTest con la selección de idioma all es muy adecuada para probar la altura, ya que contiene las comillas más cortas y más largas.

Tip

O el módulo se coloca en la parte inferior de la página.

Estilo

La cita mostrada puede personalizarse mediante hojas de Cascading Style Sheets (CSS). El elemento DIV de la clase quote encierra toda la cita, donde, por ejemplo, puede establecerse un borde. Contiene dos elementos DIV de las clases quotation para la cita y source para el autor y la fuente. El siguiente ejemplo elimina la decoración estándar del enlace (subrayado), pone la cita en fuente negra y más grande de lo normal. La fuente (con o sin enlace) se muestra en gris:

styling_es

Para ello, cree un Archivo nuevo en el directorio CSS de la Plantillas: Personalizar:

div.quote * a {
  text-decoration: none;
  color: black;
  font-size: larger;
}
div.quote div.source, div.quote div.source a {
  color: gray;
}

Ejemplos en Internet

Citas en alemán

Citas en inglés

  • estilizadas para que coincidan con el tema del sitio web en digitalflem.com:
styled

A partir del: 16 de diciembre de 2023

Situaciones de error

404 No quote found for given parameters

Si los parámetros se combinan desfavorablemente, no queda ninguna cita disponible para seleccionar. En el siguiente ejemplo, se han configurado el idioma Español y el autor Douglas Adams. Sin embargo, no hay ninguna cita de Douglas Adams almacenada en español:

404 No quote found for given parameters: language=es (Spanish), authorId=345 (Douglas Adams). "https://api.zitat-service.de/v1/quote_html?contentOnly=true&V_2.0.1_5.0.0_S&language=es&authorId=345"

👉 Selecciona los parámetros para que se sigan encontrando citas.


Error: Failed to fetch (refused to connect)

Si CSP (Content Security Policy) está activada y se produce un mensaje de error, como por ejemplo

Error: Failed to fetch "https://api.zitat-service.de/v1/quote_html?contentOnly=true&language=es"

Compruebe el error en la consola JavaScript del navegador. Si encuentra lo siguiente

zitatservice.js:32 Refused to connect to 'https://api.zitat-service.de/v1/quote_html?contentOnly=true&language=es' because it violates the document's Content Security Policy.

👉 Entonces la configuración CSP (Content Security Policy) del sitio web debe ser complementada con connect-src para la API para poder obtener las citas desde allí. Por ejemplo en una configuración de Apache

# CSP
Header set Content-Security-Policy "connect-src 'self' api.zitat-service.de;"

👉 Alternativamente, el Método de consulta para el módulo se puede cambiar a Desde Joomla.


RuntimeException Connection timed out

Se permite un máximo de tres segundos para recuperar un presupuesto. Si se excede el tiempo, se muestra un mensaje de error, como por ejemplo

RuntimeException Connection timed out after 3000 milliseconds "https://api.zitat-service.de/v1/quote_html?contentOnly=true"

👉 Esto podría ocurrir con una conexión de red muy pobre. Si el servicio realmente no está disponible, por favor cree un ticket.


Invalid data "Goethe" for parameter "authorId"

En versiones antiguas del plugin (anteriores a la 2.0.0), se utilizaban nombres para los parámetros configurados, pero éstos ya no funcionan tras una actualización del plugin. En el siguiente ejemplo, Goethe se guardó como autor:

Error: Datos no válidos "Goethe" para el parámetro "authorId". "https://api.zitat-service.de/v1/quote_html?contentOnly=true&authorId=Goethe"

👉 Tras actualizar el plugin a una versión a partir de la 2.0.0, los parámetros guardados como autor, categoría y usuario deben volver a seleccionarse una vez para cambiar a los ID únicos.


Tickets

¿Hay algún error o se necesita alguna mejora? Por favor, cree un GitHub Ticket. 👍