shortcake

Shortcake (ui de código corto)

Colaboradores: Fusioningineering, Mattheu, Danielbachhuber, Zebulonj, Goldenapples, Jitendraharpalani, Sanchothefat, Bfintal, Davisshaver, Garyj, Mte90, Fredserva, Khromov, Bronsonquick, Dashaluna, Mehigh, Sc0ttkclark, KhrAftner, Pravyner, Pravyner, Pravdom
Etiquetas: códigos cortos
Requiere al menos: 4.5
Probado hasta: 5.0.3
Etiqueta estable: 0.7.4
Licencia: GPLV2 o posterior
Uri de licencia: http://www.gnu.org/licenses/gpl-2.0.html

Shortcake hace que el uso de códigos cortos de WordPress sea un pedazo de pastel.

Descripción

Utilizado junto con add_shortcode , Shortcake suministra una interfaz fácil de usar para agregar un código corto a una publicación, y verla y editarla desde el editor de contenido.

Una vez que haya instalado el complemento, deberá registrar UI para sus códigos cortos. Para inspiración, consulte ejemplos de tarta en la naturaleza.

Para informar errores o solicitudes de funciones, utilice los problemas de GitHub.

Instalación

Shortcake se puede instalar como cualquier otro complemento de WordPress.

Una vez que lo haya hecho, deberá registrar la interfaz de usuario para su código.

Nuevo en 0.4.0 es la capacidad de adjuntar funciones de JavaScript a las actualizaciones de atributos de eventos. Los ganchos de acción se pueden usar para mostrar o ocultar dinámicamente un campo basado en el valor de otro, o para implementar reglas de validación personalizadas.

Preguntas frecuentes

¿Cómo registro la interfaz de usuario para pares arbitrarios de clave/valor como atributos de código corto?

Shortcake no es compatible con los pares de valor de clave personalizada => como atributos de código corto porque no es una gran experiencia de usuario.

Después de actualizar a Shortcake 0.7.x, algunos de los campos de interfaz de usuario de código corto (Post Select, User Select, etc.) no funcionan como se esperaba. ¿Qué puedo hacer?

En la versión 0.7.0, actualizamos a la rama más reciente de la biblioteca SELECT2, que proporciona los campos Select mejorados en estos tipos de campo. Esto causa un conflicto conocido con complementos que enquean versiones más antiguas de SELECT2. (Los complementos populares con conflictos conocidos incluyen WooCommerce y Advanced Custom Fields Pro, entre otros).

Si encuentra que está experimentando conflictos con estos complementos, puede configurar un indicador para cargar Select2 en un espacio de nombres distinto definiendo el constante SELECT2_NOCONFLICT en su wp-config.php (o en cualquier lugar que se define antes del "gancho de inicio").

 define( 'SELECT2_NOCONFLICT', true );

Pruebas de ejecución

Tenemos cobertura de prueba para PHP usando PHPUNIT y JavaScript usando Jasmine.

Ejecución de pruebas localmente

Las pruebas de jazmín se pueden ejecutar utilizando grunt jasmine y también se ejecutan como parte de la tarea grunt scripts . Para actualizar los archivos centrales de WordPress utilizados por Jasmine Test Suite, ejecute grunt updateJasmineCoreScripts --abspath="/path/to/wordpress-install" .

Capturas de pantalla

1. Sin pastel cortos, los códigos cortos tienen una interfaz de usuario mínima.

2. Pero con pastel corto, TinyMCE representará el código corto en una vista TinyMCE.

3. Y agregue una interfaz de usuario fácil de usar para editar contenido y atributos de código corto.

4. Agregue nuevos códigos cortos a su publicación a través de "Agregar medios".

Aviso de actualización

0.4.0

Hemos eliminado la cuña de compatibilidad para el argumento del atributo de placeholder . Debe registrar un marcador de posición para su campo utilizando el meta argumento.

0.3.0

Hemos eliminado la cuña de compatibilidad para el atributo content mágico. Si estaba utilizando esto para admitir el contenido interno, deberá cambiar su registro de IU para usar inner_content .

Colegio de cambios

0.7.4 (16 de enero de 2019)

• Compatibilidad del editor de bloques: evite que las plantillas se emitan antes del cabezal del documento, lo que obligó al navegador a QuirksMode, rompiendo algunos estilos CSS en el editor de bloques.
• Corrección de errores: la interrupción anterior.
• Corrección de errores: corrige un error de JavaScript que causaría que el modal del elemento de poste inserto esté en blanco si algún código corto contiene un campo de selección sin opciones visibles y sin configuración predeterminada.
• Se corrigió el error: corrige un error donde el botón "Seleccionar archivos" en el controlador de medios no respondiera después de insertar un elemento post.
• Mejora: Agregue un atributo de campo opcional "Permitir claro" que se pase a los campos SELECT2 (POST, USER o Term Select) para que los campos de selección múltiple se puedan borrar con un solo clic. (Esta opción predetermina y no debe afectar los campos existentes).

0.7.3 (5 de septiembre de 2017)

• Seguridad: use la validación de NonCe en la devolución de llamada de los códigos cortos de AJAX para proteger contra CSRF.
• Corrección de errores: asegúrese de que el mismo JS se incendia en todos los tipos de campo.
• Se corrigió el error: corrige errores que afecten múltiples campos de selección (los valores no pueden ser no establecidos una vez establecidos, y no se pueden establecer múltiples valores predeterminados).
• Corrección de errores: evitar campos codificados que contienen dos por ciento de los caracteres que se rompen.
• Corrección de errores: solucione algunos problemas en los que el estado modal de los medios no se restableció correctamente si se cerró un código corto sin guardar.
• Corrección de errores: Casos de soporte donde hay múltiples instancias WP_Editor en una página, y asegúrese de que el código corto que se edita se envíe a la página correcta.
• Mejora: cuando el campo Post_Select se selecciona desde más de un tipo de publicación, muestre el tipo de publicación junto con el nombre de la publicación para una selección más fácil.
• Mejora: Muestre miniaturas de archivo adjunto para cualquier tipo de archivo adjunto, no solo imágenes.
• Mejora: agregue más mensajes de error útiles si no se registran los códigos cortos con la interfaz de usuario de Shortcake.
• Actualizar la traducción noruega

0.7.2 (24 de abril de 2017)

• Corrección de errores: arreglar el comportamiento en WordPress 4.7.4 donde editar un código corto insertaría un nuevo código corto en el editor en lugar de actualizar el código corto que se está editando.
• Corrección de errores: el reemplazo utilizado para escapar de los caracteres porcentuales (%) en atributos solo reemplazó la primera aparición
• Corrección de errores: para campos de selección con múltiplo = true, permita que se seleccionen múltiples opciones de forma predeterminada
• Se agregó i18n para todas las cadenas en la plantilla de campo de archivo adjunto
• Traducción finlandesa agregada

0.7.1 (16 de marzo de 2017)

• Cambie el formato de código corto para agregar un espacio antes de la barra de cierre de cierre autónomo.
• Arreglar la alineación de las aves de archivo adjunto con nombres de archivo largos.
• Corrección de errores: establezca un valor inicial en los campos de selección (anteriormente, no se establecería ningún valor para un campo SELECT a menos que el usuario interactúe con el campo).
• Mejora/fijación: reutilice una copia del modal de los medios y restablezca su estado al cerrar, en lugar de crear un marcado duplicado cada vez que se accede al modal.
• Compatibilidad: utiliza la versión "completa" de Select2.JS 4.0.3 para evitar conflictos de complementos con otros complementos que esperan que la versión completa esté enqueada.
• Compatibilidad: Agregue el indicador SELECT2_NOCONFLICT para cargar SELECT2 en un espacio de nombres único para evitar conflictos con otros complementos que están cargando select2.js versión 3.
• Se agregó la traducción noruega.
• Múltiples correcciones de estilo de codificación.

0.7.0 (18 de noviembre de 2016)

• Agrega el botón "Agregar elemento post" a los botones de medios: uno haga clic para abrir la lista de códigos cortos, en lugar de hacer clic en el botón "Agregar medios" y luego encontrar "insertar el elemento post" en el menú.
• Se agregó el tipo de campo "Term Seleccionar".
• Se agregó el tipo de campo "Usuario Seleccionar".
• Se agregaron nuevos ganchos que disparan en la representación/edición/cierre de un código corto, que puede usarse para los tipos de campo que requieren inicialización o limpieza personalizada de JavaScript.
• Seleccione campos: agregue soporte completo para múltiples campos de selección.
• Seleccione campos: admite pedidos personalizados de opciones.
• Seleccione Campos: Opción de agrupación de soporte en <optgroup> s pasándolos como una matriz anidada.
• Campos de archivo adjunto: admite selección múltiple.
• Campos de archivos adjuntos: Soporte de imágenes SVG (si las cargas SVG están habilitadas por un complemento o tema).
• Corrección de errores: manejar letreros porcentuales al decodificar campos con encode=true especificado.
• Corrección de errores: solucione el problema donde toma dos clics en un código corto en el editor para aparecer el modal de edición de shortcode.
• Corrección de errores: solucionar el problema al buscar códigos cortos por nombre donde si múltiples códigos cortos comienzan con la cadena de búsqueda, solo se devuelve el primero.
• Corrección de errores: solo emite un campo de descripción en un atributo si no está vacío.
• Compatibilidad: elimine las cuñas para manejar el modal de los medios en WP 4.1 y 4.2.
• Compatibilidad: Actualice la biblioteca SELECT2 a 4.0.3 para evitar conflictos con otros complementos que usan la última versión de SELECT2.
• Traducción turca agregada.
• Se agregó la traducción finlandesa.
• Se agregó la traducción sueca.
• Se agregó la traducción húngara.

0.6.2 (12 de noviembre de 2015)

• Se corrigió el error: escucha el evento "Cambiar" en los botones de radio y las casillas de verificación para garantizar que se actualicen los atributos de código corto.
• Bug SEX: Garantiza register_shortcode_ui siempre se ejecuta antes de llamar a get_shortcodes (). Corrige post seleccionar la devolución de llamada AJAX cuando se use register_shortcode_ui gancho.

0.6.1 (9 de noviembre de 2015)

• Corrige JavaScript TypeError al hacer clic en los elementos del menú de marco de medios.
• Corrige enlaces en ReadMe.

0.6.0 (2 de noviembre de 2015)

• Admite un argumento opcional encode=true para los atributos, para permitir un soporte HTML limitado. Los atributos deben ejecutarse a través de shortcode_atts() para decodificar correctamente.
• Define una constante de SHORTCODE_UI_DOING_PREVIEW al representar una vista previa de código corto, que permite que las devoluciones de llamada sirvan una representación diferente del código corto en TinyMCE.
• Cuando un archivo adjunto ya está seleccionado para un atributo de código corto, la biblioteca de medios de apertura lo incluirá seleccionado.
• Alineación vertical de icono limpio en la interfaz de usuario del elemento posterior al inserto.
• Se agregaron clases de utilidad CSS a todos los HTML de campo. Por ejemplo, el campo de fijación ahora está envuelto con shortcode-ui-field-attachment .
• Se agregaron filtros para modificar los argumentos de UI de código corto en el registro.
• Limpie el complemento de ejemplo, por lo que es una referencia de desarrollador mucho más útil.
• Utiliza JavaScript Regex de Core para analizar los códigos cortos, en lugar de mantener regex separado.
• Permite HTML en etiquetas y descripciones de campo.
• Se agregó la traducción danesa.
• Traducción italiana agregada.
• Se agregó la traducción alemana.
• Integración del núcleo: admite plenamente PHP 5.2.
• Corrección de errores: persiste los atributos de código corto y el contenido interno cuando no hay UI registrada para ellos. Anteriormente, serían descartados.
• Corrección de errores: Muestre la descripción en el campo Post Seleccionar.
• Corrección de errores: el evento de cambio de campo de atributo se vincula al evento input en lugar de keyup .
• Notas de la versión completa

0.5.0 (26 de agosto de 2015)

• Campo de archivo adjunto: hizo que fuera más fácil cambiar el archivo adjunto haciendo clic en la miniatura; Se agregaron metadatos de fijación en la vista de campo.
• Campo de archivo adjunto: Refactorizado JavaScript para activar eventos.
• Se agregó un tipo de entrada range .
• Introdujo un gancho register_shortcode_ui para complementos para registrar más de forma segura UI con.
• La pestaña de vista previa eliminada para acercar la experiencia del usuario de Shortcake a Core, en la que se prefiere la vista previa visual en línea a través de una vista previa separada en el modal de los medios.
• Limpió JavaScript usando Jshint.
• Se agregó la traducción rusa.
• Se agregó la traducción portuguesa.
• Se agregó PHPDOC a todas las clases.
• Corrección de errores: persiste inner_content para un código corto incluso cuando la interfaz de usuario no está definida.
• Corrección de errores: presionar ESC en una vista de tarta de cortos ahora cerrará el modal. (Fijo en el núcleo).
• Corrección de errores: presionar eliminar cuando se selecciona una vista previa de tarta corta en el editor visual ahora da como resultado que se elimina el código corto. (Fijo en el núcleo).
• Corrección de errores: la función de 'búsqueda' de tarta corta ya no entra en conflicto visualmente con la cuadrícula de códigos cortos en tamaños de pantalla pequeña. (Fijo en el núcleo).
• Corrección de errores: use get_post_type() en lugar de get_current_screen()->post_type para que el contexto se establezca correctamente en el frontend.
• Notas de la versión completa

0.4.0 (22 de junio de 2015)

• Uso de los gancos de Carldanley/WP-JS para una API básica para registrar las devoluciones de llamada JS en los atributos de código corto.
• El campo de archivo adjunto utiliza un indicador de carga cuando la vista previa para un accesorio se está cargando.
• Se agregó la traducción china.
• Se agregó la traducción al francés.
• Se agregó traducción al español.
• Corrección de errores: evita el fatal cuando el editor se carga en el contexto frontend.
• Corrección de errores: el campo de color también admite meta argumento.
• Corrección de errores: elimina el espacio en blanco de los códigos cortos sin atributos.
• Corrección de errores: elimina el corte doble en la ruta del editor CSS.
• Notas de la versión completa

0.3.0 (27 de abril de 2015)

• Cambio de ruptura : hemos eliminado la cuña de compatibilidad para el atributo content mágico. Si estaba utilizando esto para admitir el contenido interno, deberá cambiar su registro de IU para usar inner_content .
• Nuevo tipo de campo post_select para seleccionar desde una lista de publicaciones. Admite un parámetro query adicional para modificar la consulta de búsqueda.
• Usando un nuevo argumento post_type , la interfaz de usuario de Shortcode se puede registrar para tipos de publicación específicos. Esto es útil si desea que la interfaz de usuario para un código corto determinado solo aparezca en tipos de publicaciones específicos.
• Para cada atributo de código corto, se puede especificar un meta argumento para agregar atributos HTML arbitrarios al campo. Hemos agregado una cuña de compatibilidad para el argumento de placeholder existente. Esta cuña de compatibilidad se eliminará en V0.4.
• Al insertar un código corto, la interfaz de usuario muestra un mensaje útil cuando el código corto no tiene atributos para configurar. Anteriormente, al usuario se le presentaba una pantalla relativamente en blanco.
• Nuestro complemento de ejemplo se puede activar a través del administrador de WordPress.
• Haga clic en "Insertar el elemento post" en el menú izquierdo actúa efectivamente como botón Atrás para seleccionar un código corto.
• El lenguaje en torno a la experiencia de edición refleja el corto código que está editando. Por ejemplo, con un código corto Pullquote, "Editar el elemento post" se convierte en "Editar PullQuote".
• Se agregó la traducción holandesa.
• Archivos de JavaScript de origen se trasladó a js/src para mayor claridad entre el origen y el JavaScript construido.
• Los archivos PHP se escanean utilizando PHP_CODESNIFFER.
• Corrección de errores: los atributos de código corto sin cesar son compatibles correctamente.
• Corrección de errores: campo de archivo adjunto registra correctamente las dependencias.
• Se corrigió el error: la experiencia de "insertar el elemento post" debería funcionar cuando el editor visual está deshabilitado. El pastel corto solo se combina libremente con TinyMCE.
• Corrección de errores: los estilos del editor se cargan after_setup_theme para evitar fatales.
• Notas de la versión completa.

0.2.3 (8 de abril de 2015)

• FIJO WP 4.1 Problema de compatibilidad con versiones anteriores restaurando argumentos aprobados para ver la cuña de compatibilidad de TinyMCE.

0.2.2 (6 de abril de 2015)

• Actualizar los argumentos pasados ​​a TinyMCE View Render para la compatibilidad WP 4.2. El argumento previamente aprobado no era necesario, por lo que eliminar no rompe la compatibilidad hacia atrás.

0.2.1 (18 de marzo de 2015)

• Asegúrese de que el uso de jQuery respeta jQuery.noconflict () modo en WP.

0.2.0 (18 de marzo de 2015)

• JS abstraído usando Browserify.
• Mejoras para "agregar post elemento" UI: códigos cortos ordenados alfabéticamente; Búsqueda basada en la etiqueta.
• Mucho más fácil de seleccionar vistas previas de código cortos que incluyan iFrames.
• WordPress 4.2 Compatibilidad.
• Se agregó el recolector de color a la lista de campos potenciales.
• Corrección de errores: compatibilidad IE11.
• Corrección de errores: el campo de casilla de verificación ahora se puede desmarcar.
• Notas de la versión completa.

0.1.0 (23 de diciembre de 2014)

• Admite todos los tipos de entrada HTML5 para campos de formulario.
• Pestaña de vista previa de código corto dentro de la experiencia de edición. }* Reelabeló la interfaz de usuario alrededor de "elementos de publicación", que es más descriptivo que los "elementos de contenido".
• Muchas correcciones de errores.
• Notas de la versión completa.