Add_shortcode wordpress php

WordPress añadir shortcode

Contents

Se debe tener cuidado a través del prefijo u otros medios para asegurar que la etiqueta shortcode que se agrega es única y no entrará en conflicto con otras etiquetas shortcode ya agregadas. En el caso de una etiqueta duplicada, la etiqueta cargada en último lugar tendrá prioridad.

Sólo puede haber un gancho para cada shortcode. Esto significa que si otro plugin tiene un shortcode similar, éste anulará el tuyo, o el tuyo anulará el suyo, dependiendo del orden en que se incluyan y/o ejecuten los plugins.

Tenga en cuenta que la función llamada por el shortcode nunca debe producir una salida de ningún tipo. Las funciones del shortcode deberían devolver el texto que se va a utilizar para reemplazar el shortcode. Producir la salida directamente conducirá a resultados inesperados. Esto es similar a la forma en que las funciones de filtro deberían comportarse, en el sentido de que no deberían producir efectos secundarios inesperados de la llamada, ya que usted no puede controlar cuándo y desde dónde son llamadas.

Código corto de WordPress

Ahora que has creado tu plugin, vamos a profundizar en la definición de un shortcode. Un shortcode es un elemento que añades a una página o post que se convierte en otra cosa por el plugin o tema que registró el shortcode.

Si instalas y activas WPMerchant y añades este shortcode a un post o página, puedes recoger los pagos de tus clientes. Este shortcode se convierte en un formulario de pago por el plugin WPMerchant. Cuando veas la página a la que has añadido el plugin, verás lo siguiente:

Este archivo es el controlador para todas sus acciones de administración. El método __construct es una función especial de PHP que se ejecuta cuando se inicializa una clase de PHP. Piensa en ello como tu tabla de contenidos para todas las funciones de esta página.

add_shortcode es una función de WordPress y le permite engancharse al código de WordPress y crear un nuevo shortcode que puede ser usado en páginas, entradas o cualquier otro tipo de entrada.El parámetro ‘test_shortcode’ en la función add_shortcode es el aspecto que tendrá el shortcode real.    El otro parámetro, array( $this, ‘testShortcode’ ), define qué método debe ejecutar WordPress cuando ese shortcode se encuentra en una página o entrada.

Ejemplo de código corto de WordPress

La API se encarga de todo el análisis sintáctico, eliminando la necesidad de escribir una expresión regular personalizada para cada shortcode. Se incluyen funciones de ayuda para establecer y recuperar los atributos por defecto. La API admite códigos cortos autocerrados y cerrados.

Esto crea un shortcode «[bartag]» que admite dos atributos: [«foo» y «bar»]. Ambos atributos son opcionales y adoptarán las opciones por defecto [foo=»algo» bar=»algo más»] si no se proporcionan. El shortcode volverá como foo = {el valor del atributo foo}.

Cuando se muestre el_contenido, la API de shortcode analizará cualquier shortcode registrado como «[myshortcode]», separará y analizará los atributos y el contenido, si los hay, y los pasará a la función de manejo de shortcode correspondiente. Cualquier cadena devuelta (que no se haga eco) por el manejador del shortcode se insertará en el cuerpo de la entrada en lugar del propio shortcode.

Las claves del array son los nombres de los atributos; los valores del array son los valores de los atributos correspondientes. Además, la entrada número cero ($atts[0]) contendrá la cadena que coincida con la regex del shortcode, pero SÓLO SI es diferente del nombre de la llamada de retorno. Vea la discusión de los atributos, más abajo.

Woocommerce_mi_cuenta

Normalmente WordPress no permite añadir código PHP a las páginas o entradas. Eso es lo mejor; ¡no quieres que los clientes descubran el poder de la función de desvinculación! Sin embargo, puede crear funciones personalizadas que se ejecutan cuando se encuentra un shortcode dentro del texto de la entrada.

Las funciones de shortcode se pueden añadir al código del plugin o al archivo functions.php de tu tema. Si es esto último, recomendaría crear un archivo shortcodes.php separado, y luego añadir include(‘shortcodes.php’); a functions.php.

La siguiente función shortcode genera un mapa del sitio de la jerarquía de la página. Se pueden pasar tres parámetros opcionales: un título, el ID de la lista ul resultante y un valor de profundidad que indica el número de niveles de navegación de la página.