Guía de Integración del Plugin Cornerstone

En este artículo, vamos a explicar cómo instalar el plugin Cornerstone cuando estás utilizando un tema de terceros, así como cómo integrarlo directamente con temas y plugins de terceros.

Cornerstone Standalone Overview

Cornerstone es una familia de constructores de sitios web poderosos. Los usuarios Pro tienen acceso a todos los constructores de Cornerstone, que están integrados en el tema. Los usuarios X tienen acceso al Page Builder y se administra como un plugin independiente (incluido con la compra). La versión independiente de Cornerstone, explicada en este artículo, se utiliza con otros temas y constructores de terceros.

Cómo descargar el archivo de instalación del plugin Cornerstone

Para descargar el archivo zip de instalación del plugin Cornerstone, ve al Tablero de Themeco y busca la licencia en el menú de la izquierda. A continuación, haz clic en el botón “Descargar” y el archivo zip de instalación del plugin Cornerstone se descargará a tu ordenador.

Cómo instalar el plugin Cornerstone

Una vez que hayas descargado el plugin Cornerstone, estás listo para instalarlo. En tu panel de administración de WordPress, ve a “Plugins” en el menú de la izquierda y luego haz clic en “Añadir nuevo”. A continuación, haz clic en “Subir plugin” y selecciona el archivo zip que descargaste. Finalmente, haz clic en “Instalar ahora” y luego en “Activar plugin” para activar Cornerstone en tu sitio web.

Cómo integrar Cornerstone en un tema de terceros

Si eres un desarrollador de temas y estás interesado en integrar el plugin Cornerstone en tu tema, sigue estos pasos:

Lo que debes hacer y evitar

Antes de decidir integrar Cornerstone en un tema de terceros, considera los siguientes puntos:

• Crea tus propios plugins que contengan nuevos elementos de Cornerstone (quizás a partir de tus shortcodes preexistentes).
• Agrega tu propio estilo a los elementos de Cornerstone. Incluso puedes desactivar completamente el estilo predeterminado.
• No cambies la estructura de nuestros elementos o shortcodes. Esto es importante para la portabilidad de datos.
• No alteres la interfaz de usuario de ninguna manera, incluyendo la introducción de nuevos controles o características personalizadas del constructor.
• No extiendas los elementos existentes, incluyendo secciones, filas y columnas, con nuevos controles. Sin embargo, puedes usar tu propio estilo personalizado para cambiar su apariencia.
• Si te adhieres a nuestras APIs documentadas, no habrá problema, pero te pedimos que evites las soluciones alternativas que puedan surgir en WordPress.
• Entendemos que nuestras restricciones son más estrictas que las de otros constructores, pero estamos comprometidos con preservar la experiencia de usuario de Cornerstone, sin importar el tema o la combinación de plugins que se utilicen.
• También nos comprometemos a preservar la portabilidad del contenido creado con Cornerstone. Si necesitas una función o control en específico que no está disponible en Cornerstone, háznoslo saber, tal vez podamos trabajarlo para incorporarlo en el plugin principal.

Incluir Cornerstone en tu tema

Para incluir Cornerstone en tu tema, sigue estos pasos:

1. Descarga el archivo zip del plugin Cornerstone desde el Tablero de Themeco.
2. En tu panel de administración de WordPress, ve a “Plugins” en el menú de la izquierda y haz clic en “Añadir nuevo”.
3. Luego, haz clic en “Subir plugin” y selecciona el archivo zip que descargaste.
4. Después de que se haya cargado el archivo, haz clic en “Instalar ahora” y luego en “Activar plugin”.

Funciones y Hooks para desarrolladores de temas

Proporcionamos una serie de funciones y hooks que puedes utilizar en tu tema para personalizar la experiencia del uso de Cornerstone. Estos te permitirán crear tus propios elementos y personalizar la apariencia de Cornerstone en tu tema. Aquí tienes algunos ejemplos:

• Puedes crear tus propios plugins que contengan nuevos elementos de Cornerstone.
• Además, puedes agregar tu propio estilo a los elementos de Cornerstone.
• Incluso puedes desactivar el estilo nativo por completo y crear tu propio diseño personalizado.
• Si necesitas más control sobre los elementos existentes, puedes utilizar tu propio estilo para cambiar su apariencia sin modificar la estructura.
• Nuestro objetivo es preservar la experiencia de usuario de Cornerstone y la portabilidad del contenido creado con él.

Ocultar enlaces de Themeco

Como mencionamos anteriormente, Cornerstone tiene una conexión con Themeco, pero entendemos que es posible que desees limitar la exposición de nuestra marca en tus propios productos. Por eso, ofrecemos opciones para ocultar algunos elementos relacionados con Themeco, como el aviso de validación global y las ofertas de Themeco. Puedes utilizar una función específica para ocultar estos elementos, como se muestra a continuación:

cornerstone_theme_integration( array(
  'remove_global_validation_notice' => true,
  'remove_themeco_offers' => true
) );

Añadir tipos de publicaciones predeterminados

Cornerstone está activado de forma predeterminada para las publicaciones y las páginas. Si deseas incluir otros tipos de publicaciones adicionales o desactivar las publicaciones por defecto, puedes utilizar la función `cornerstone_set_default_post_types`. Te mostramos algunos ejemplos:

// Eliminar "Entradas" para que no esté activado de forma predeterminada.
function my_theme_set_cornerstone_default_post_types() {
  cornerstone_set_default_post_types( array( 'page' ) );
}
add_action( 'cornerstone_integrations', 'my_theme_set_cornerstone_default_post_types' );

// Agregar tipo de publicación "Mi Tema Portfolio".
function my_theme_set_cornerstone_default_post_types() {
  cornerstone_set_default_post_types( array( 'post', 'page', 'my-theme-portfolio' ) );
}
add_action( 'cornerstone_integrations', 'my_theme_set_cornerstone_default_post_types' )

Eliminar estilos front-end de Cornerstone

Si deseas personalizar los elementos de Cornerstone con tus propias hojas de estilo, puedes evitar que Cornerstone cargue los estilos predeterminados en el front-end utilizando los siguientes filtros:

add_filter( 'cornerstone_enqueue_styles', '__return_false' );

Recuerda que si optas por esta opción, deberás proporcionar tus propios estilos para el margen base y los anchos de contenedor.

Usar una clase de integración

Las clases de integración son opcionales pero ofrecen una forma conveniente de organizar tu código. Puedes crear una clase que incluya tus integraciones y luego registrarla en el hook `cornerstone_integrations`. Aquí tienes un ejemplo:

class Cornerstone_Integration_My_Theme {
  // Constructor para tu clase de integración
  public function __construct() {
    // Puedes registrar tus elementos personalizados aquí
  }
}

function my_theme_register_cornerstone_integration() {
  require( 'path/to/class-my-theme-cornerstone-integration.php' );
  cornerstone_register_integration( 'my-theme', 'Cornerstone_Integration_My_Theme' );
}
add_action( 'cornerstone_integrations', 'my_theme_register_cornerstone_integration' );

Resumen

En resumen, hemos hablado sobre la versión independiente del plugin Cornerstone y cómo descargarlo e instalarlo. También hemos discutido lo que debes hacer y evitar al integrar Cornerstone en un tema de terceros. Además, hemos presentado algunas funciones y hooks que puedes utilizar para personalizar la integración de Cornerstone en tu tema. Esperamos que esta guía te ayude a aprovechar al máximo el potencial de Cornerstone en tus proyectos de WordPress. Si tienes alguna pregunta, no dudes en contactarnos.