Tarjetas de contenido

Preguntas más frecuentes

Hay dos formas de insertar tarjetas de contenido en las publicaciones de WordPress: shortcode y oEmbed.

Instrucciones de instalación

• Vaya a su área de administración y seleccione Complementos -> Agregar nuevo en el menú.
• Buscar “Tarjetas de contenido”.
• Haga clic en instalar.
• Haga clic en Activar.

Código corto

El código corto es la forma más sencilla: solo pones [contentcards url="http://yourdomain.com/article/1"] en el contenido de su publicación y se reemplaza con una tarjeta de contenido.
El shortcode acepta dos atributos:

• url (requerido): enlace al sitio para el que desea mostrar la Tarjeta de contenido.
• objetivo (opcional): si desea forzar que los enlaces se abran en una nueva pestaña, use target = "_ en blanco" Lo mismo harías en enlaces reales. Esto anula la opción global en la página de configuración de las tarjetas de contenido.

También puede insertar el código abreviado a través de un botón en su editor visual. Comience presionando el icono de Tarjetas de contenido en la barra de herramientas del editor visual de WordPress (TinyMCE). Si no hay otros complementos agregando sus botones, nuestro botón debería ser el último en la barra de herramientas superior.

oEmbed

Si descubre que está agregando una gran cantidad de tarjetas de contenido de un solo dominio, puede ahorrarse algo de trabajo al incluir en la lista blanca ese sitio web como proveedor incorporado en la página de configuración de la tarjeta de contenido.

Los sitios incluidos en la lista blanca funcionan de la misma manera que cualquier otro proveedor oEmbed en WordPress (YouTube, Twitter, SoundCloud, etc.). Solo necesita poner un enlace de texto plano en una línea separada en el editor de WordPress y será reemplazado por una Tarjeta de contenido. .

En la página Configuración de tarjetas de contenido, puede proporcionar una lista de sitios incluidos en la lista blanca. Poner solo el nombre de dominio (example.com), un dominio por línea.

Batería

Las tarjetas de contenido vienen con dos máscaras predeterminadas: Defecto y Predeterminado Oscuro – creado por Stanislav Khromov. Estas máscaras están diseñadas para proporcionar un estilo estructural mínimo y combinarse bien con el tema activo al heredar la fuente del tema.

Todos los archivos de plantillas de skin se pueden encontrar en contenido-tarjetas / skins / * directorio y se pueden sobrescribir al proporcionar la misma plantilla en el tema activo. Por ejemplo, si desea sobrescribir la hoja de estilos de las tarjetas de contenido, debe agregar content-cards.css a su directorio de temas.

La plantilla principal de la piel es content-cards.php. Si no se define ninguna otra plantilla de máscara, las Tarjetas de contenido retrocederán a esta, de la misma manera que WordPress recurre a index.php. Si desea más plantillas granulares, puede proporcionar tarjetas de contenido - {$ tipo} .php plantillas,content-cards-website.php, content-cards-article.php, etc.). $ tipo está basado en og: tipo metadatos proporcionados por el sitio web.

Tarjetas de contenido proporciona cinco nuevas etiquetas de plantilla: get_cc_data (), the_cc_data () y the_cc_target ():

• get_cc_data ($ clave, $ sanitize = falso) – devoluciones $ clave Campo de datos de OpenGraph (es decir, “título”, “descripción”, etc.). Si es valido $ desinfectar Se proporciona la función, los datos se escapan al usarla.
• the_cc_data ($ key, $ sanitize = false) – Según la tradición de WordPress, huellas dactilares los mismos datos que get_cc_data () volvería.
• the_cc_target () – Una función auxiliar especial, que imprime. target = "_ en blanco" a los enlaces si es necesario (de acuerdo con la configuración del plugin / shortcode). Uso: >.
• get_cc_image ($ size, $ sanitize = false) – nuevo en v0.9.1 – Devuelve un enlace a la imagen si la hay. La imagen predeterminada se almacena en caché en la biblioteca de medios y luego a la imagen remota. Para imágenes en caché, puede utilizar $ talla parámetro para obtener el tamaño específico de la imagen de WordPress.
• the_cc_image ($ size, $ attrs = array ()) – nuevo en v0.9.1 – Imprime una etiqueta de imagen. Usos get_cc_images ().
• the_cc_css_classes ($ classes) – nuevo en v0.9.4 – una etiqueta de plantilla filtrable para imprimir clases CSS para la división principal de la Tarjeta de contenido. Las clases CSS personalizadas también se pueden pasar a través de clase atributo en el shortcode

Tambien desde v0.9.1 puedes usar 'favicon' teclear get_cc_data () / the_cc_data () para mostrar favicon si el sitio remoto proporciona uno.

Agregar clases de CSS al contenedor de la tarjeta de contenido

Filtrar Añadir una clase es fácil gracias a la content_cards_css_classes filtrar.

add_filter ('content_cards_css_classes', function ($ classes) {
    $ clases[] = 'my_class';
    devuelve $ clases;
});

Código corto También puede agregar clases CSS personalizadas tarjeta por tarjeta usando clase atributo en el shortcode:

[contentcards url="http://arunas.co" class="my_class"]

Requerimientos

Este complemento requiere que WP_Cron funcione correctamente.

Anular las opciones predeterminadas

Si está ejecutando este complemento en un sitio múltiple, es posible que desee establecer la configuración de todo el sitio y desactivar la página de configuración de las Tarjetas de contenido en cada blog por separado.

Para ello, puede utilizar el content_cards_options gancho, como este:

add_filter ('content_cards_options', function ($ data) {

    // Desactivar la página de administración
    $ datos['enable_admin_page'] = falso;

    devuelve $ datos;
});

También puede anular una serie de otras opciones usando este gancho. Por ejemplo, aquí establecemos el tema en “default-dark”:

add_filter ('content_cards_options', function ($ data) {

    // Desactivar la página de administración
    $ datos['skin'] = 'por defecto-oscuro';

    devuelve $ datos;
});