Descrición
O plugin Shortcoder permite crear shortcodes personalizados para HTML, JavaScript, CSS e outros fragmentos de código. Agora os shortcodes poden usarse en entradas/páxinas e o fragmento substituirase no seu lugar.
✍ Crea shortcodes facilmente
- Dálle un nome ao shortcode
- Pega o HTML/JavaScript/CSS como contido do shortcode
- Garda!
- Agora inserir o shortcode
[sc name="my_shortcode"]na túa entrada/páxina. - Listo! Xa tes o HTML/Javascript/CSS na túa entrada.
✨ Características
- Crea shortcodes personalizados facilmente e úsaos en calquera lugar onde se admitan shortcodes.
- Usa calquera HTML, Javascript ou CSS como contido do shortcode.
- Inserir: parámetros personalizados no shortcode
- Inserir: parámetros de WordPress no shortcode
- Varios editores: modos Código, Visual e Texto.
- Desactiva globalmente o shortcode cando non sexa necesario.
- Desactiva o shortcode en ordenadores ou dispositivos móbiles.
- Un botón no editor de entradas para escoller os shortcodes que inserir.
- Executa HTML de bloques no contido do shortcode.
- Inserir shortcodes no editor Gutenberg/de bloques.
🎲 Un exemplo de uso
- Crea un shortcode chamado «adsenseAd» na páxina de administración de Shortcoder.
- Pega o código de AdSense na caixa e gárdao.
- Usa
[sc name="adsenseAd"]nas túas entradas e páxinas. - Listo!!! O código do anuncio substitúese e aparece na entrada.
- Agora podes editar o código do anuncio nun só lugar e o código actualizarase en todos os lugares onde se use o shortcode.
Do mesmo xeito, pódense crear shortcodes para os fragmentos usados con frecuencia.
Tamén podes engadir parámetros personalizados (como %%id%%) dentro dos fragmentos e cambiar o seu valor así: [sc name="youtube" id="GrlRADfvjII"] ao usalos.
🧱 Uso no editor de bloques
Aínda que os shortcodes se poden usar manualmente en calquera lugar, Shortcoder ofrece as seguintes opcións para seleccionar e inserir facilmente os shortcodes creados ao traballar co editor de bloques.
- Bloque Shortcoder
- Botón da barra de ferramentas para seleccionar e inserir shortcodes de forma integrada (en «máis»)
💎 Actualiza a PRO
Shortcoder tamén ofrece unha versión PRO con características adicionais para mellorar aínda máis a experiencia. Na versión PRO ofrécense as seguintes características.
- Editor personalizado – Edita o contido dos shortcodes usando o editor de bloques ou plugins maquetadores de páxinas como Elementor e WPBakery.
- (Novo) Tradución con WPML – Traduce o contido dos shortcodes con WPML.
- Revisións – Compatibilidade coas revisións para o contido dos shortcodes.
- Localizar shortcode – Busca as entradas e páxinas onde se usa un shortcode.
- Código extra – Inclúe código extra no pé de páxina cando se usa un shortcode nunha páxina.
Primeiros pasos con Shortcoder – PRO
Ligazóns
Capturas
Blocks
Este plugin proporciona 1 bloque.
- Shortcoder
Instalación
- Extrae o arquivo comprimido e sube o cartafol
Shortcoderao directorio/wp-content/plugins/. - Activa o plugin desde o menú
Pluginsde WordPress. - Abre a páxina de administración desde a ligazón «Shortcoder» do menú de navegación.
Preguntas frecuentes
Visita a páxina de documentación do plugin para ver a lista completa de FAQ.
-
Cales son os caracteres permitidos para o nome do shortcode?
-
Os caracteres permitidos son letras, números, guións e guións baixos.
-
O meu shortcode non funciona no meu maquetador de páxinas!
-
Consulta co teu plugin maquetador de páxinas para confirmar se o bloque/lugar/área onde se usa o shortcode pode executar shortcodes. Se é así, o shortcode debería funcionar correctamente, igual que os shortcodes normais de WordPress.
-
O meu shortcode non funciona!
-
Comproba o seguinte se notas que o contido do shortcode non se mostra ou que a saída non é a esperada.
- Comproba se se mostra o contido do shortcode. Se non se ve, revisa os axustes do shortcode para ver se hai algunha opción activada que restrinxa onde e cando se mostra. Confirma tamén que o nome do shortcode é correcto e que non hai un atributo
nameduplicado para o shortcode. - Se o shortcode se mostra pero a saída non é a esperada, proba o contido do shortcode nun contorno illado e confirma que funciona correctamente. Ás veces poden ser factores externos, como o tema ou outro plugin, os que entren en conflito co contido do shortcode.
- Hai unha limitación coñecida na API de shortcodes cando se combinan shortcodes pechados e sen pechar. Consulta este documento para obter máis información.
- Comproba se se mostra o contido do shortcode. Se non se ve, revisa os axustes do shortcode para ver se hai algunha opción activada que restrinxa onde e cando se mostra. Confirma tamén que o nome do shortcode é correcto e que non hai un atributo
-
Podo inserir código PHP no contido do shortcode?
-
Non, polo momento o plugin só é compatible con HTML, Javascript e CSS como contido do shortcode.
-
Podo usar o editor de bloques ou maquetadores de páxinas como Elementor ou WPBakery para crear un shortcode?
-
Si, esta característica está dispoñible na versión PRO. Podes actualizar á versión PRO para deseñar cun editor personalizado e crear shortcodes con el.
Comentarios
Colaboradores e desenvolvedores
“Shortcoder — Crea shortcodes para calquera cousa” é un software de código aberto. As seguintes persoas colaboraron con este plugin.
Colaboradores“Shortcoder — Crea shortcodes para calquera cousa” foi traducido a 16 idiomas. Grazas aos desenvolvedores polas súas contribucións.
Traduce “Shortcoder — Crea shortcodes para calquera cousa” ao teu idioma.
Interesado no desenvolvemento?
Revisa o código, bota unha ollada aorepositorio SVN, ou subscríbete ao log de desenvolvemento por RSS.
Rexistro de cambios
6.6
- New: Axuste para permitir aos editores explorar e inserir shortcodes existentes desde o editor de entradas.
- Fix: Actualizado o editor de bloques de Shortcoder segundo a última API.
- Fix: Compatibilidade con WordPress 7.1
6.5.4
- Fix: A ventá emerxente para seleccionar e inserir shortcodes só está dispoñible para administradores.
- Fix: O valor dos parámetros personalizados sanearase por defecto.
- Fix: Elimínase a barra dobre na URL de inclusión do JS do botón do editor TinyMCE.
- Fix: Compatibilidade con WordPress 7.0
6.5.3
- New: Engadido un axuste xeral para sanear os valores dos campos personalizados antes de usalos no contido do shortcode.
- Fix: Compatibilidade con WordPress 6.9
6.5.2
- Fix: Sanéase o valor dos campos personalizados antes de inserilo na entrada.
6.5.1
- Fix: Engadidas comprobacións de
nullpara corrixir unha advertencia nalgúns casos.
6.5
- Fix: Compatibilidade con WordPress 6.8.
6.4
- New: Opción para establecer o nome para mostrar do shortcode xunto ao nome do shortcode.
- New: Opción para executar o HTML dos bloques de WordPress no contido do shortcode.
- Fix: Os perfís de Shortcoder rexístranse cando se activa o plugin.
6.3.2
- Fix: Comprobar os permisos ao pechar o rexistro de cambios de Shortcoder.
6.3.1
- Fix: Vulnerabilidade de Ajax de administración co nonce.
6.3
- New: Establece o valor por defecto para os parámetros dos campos personalizados.
- New: O valor por defecto dos parámetros personalizados móstrase na ventá emerxente de inserción de shortcodes.
- Fix: Restrinxido o acceso ás chamadas de admin-ajax.
- Fix: Faltaba a tradución nalgúns textos de administración.
- Fix: Eliminada a nota da ventá emerxente de inserción para shortcodes totalmente pechados.
- Fix: A liña de comentario de depuración agora ten o nome do shortcode.
6.2
- New: Opción para mostrar o contido do shortcode na páxina «Todos os shortcodes».
- Fix: Algúns textos non estaban traducidos.
- Fix: Erro no maquetador de páxinas WP Bakery ao escoller imaxes.
6.1
- New: Melloras nas metabox da pantalla de edición de shortcodes.
- Fix: Ás veces o HTML escapábase no editor.
- Fix: Compatibilidade con WordPress 6.1
6.0
- New: Introdúcese a versión PRO.
- New: Evita o bucle aniñado do mesmo shortcode.
- New: Introducidas novas accións e filtros.
- Fix: O parámetro de extracto da entrada do shortcode agora mostra o extracto completo da entrada.
- Fix: Melloras no saneamento dos datos de entrada e saída.
5.8
- New: Opción para establecer a descrición do shortcode.
- New: Introducidas novas accións e filtros.
- Fix: Pequenas melloras na IU de administración.
5.7
- New: Reordenada a columna do shortcode na páxina «Todos os shortcodes».
- New: Opción para copiar o shortcode directamente desde a páxina «Todos os shortcodes».
- New: Filtro
sc_mod_contentpara modificar o contido do shortcode antes da execución. - Fix: O shortcode non se gardaba se o campo de correo electrónico do formulario de resposta tiña un valor non válido.
- Fix: O parámetro personalizado con guión non se resaltaba no editor de código.
- Fix: Pequenas melloras na IU de administración.
5.6
- New: Os shortcodes dispoñibles para copiar/inserir agora están pechados por defecto.
- Fix: Non se mostraba o valor 0 dos parámetros personalizados.
- Fix: Compatibilidade con WordPress 5.8
5.5
- New: Páxina de axustes xerais para configurar o editor e o contido do shortcode por defecto.
- New: Bloque para inserir shortcodes reescrito desde cero.
- New: Botón da barra de ferramentas para inserir shortcodes de forma integrada.
- New: Os shortcodes agora están pechados por defecto cando se inseren desde o editor.
- Fix: Problema de análise dos campos personalizados cando están colocados un xunto a outro.
- Fix: O contido encerrado na entrada de bloque agora conserva as varias liñas.
- Fix: Pequenos refinamentos na IU.
5.4
- New: O editor de código agora cárgase localmente e non desde cloudflare.
- New: O editor de código agora mostra suxestións e resalta os erros de sintaxe.
- New: Agora pódense usar guións nos parámetros personalizados dos shortcodes.
- Fix: Xestionado o caso en que o atributo do shortcode se recibe ás veces como cadea.
- Fix: Aviso onde se chamaba incorrectamente a
wp_localize_script. - Fix: Xestionado o caso en que se pasa HTML como parámetro do shortcode.
- New: O requisito de WordPress cambiou de 4.4 a 4.9
5.3.4
- New: Probado con WordPress 5.6
- Fix: Xestionada a advertencia con
trimao obter os metadatos da páxina nalgunhas páxinas.
5.3.3
- New: Compatibilidade con
post slugcomo novo parámetro de shortcode na información de WordPress. - New: Codemirror actualizouse á última versión.
- Fix: Xestionado o problema de carga do editor de código cando hai algunha colisión.
- Fix: Xestionados os campos de entrada que teñen o atributo
idbaleiro. - Fix: Xestionado o problema de que o obxecto
$postnon estivese definido nalgúns casos. - Fix: Renomeados os usos de
__class__a__CLASS__
5.3.2
- New: No editor de código, os shortcodes resaltaranse e o tamaño da letra do editor é lixeiramente maior.
5.3.1
- New: O editor de código agora é o editor por defecto.
- Fix: Pequenos cambios na IU de administración.
5.3
- New: Engadida compatibilidade con guións baixos nos parámetros personalizados.
- New: Preparación para a internacionalización do plugin.
- Fix: A ventá emerxente de inserción de shortcodes mostra parámetros dispoñibles duplicados no caso do mesmo parámetro con maiúsculas e minúsculas diferentes.
5.2.1
- Fix: Os parámetros personalizados non se substituían nalgúns casos.
- Fix: Pequena mellora no formulario de inserción de parámetros personalizados.
5.2
- New: Agora pódense proporcionar valores por defecto aos parámetros personalizados.
- Fix: Ás veces elimináronse as etiquetas script, o marcador de posición dos campos personalizados e a barra invertida tras gardar o shortcode.
- Fix: O atributo rel modificábase nas ligazóns.
- New: Engadida a ligazón «Xestionar shortcodes» á páxina da lista de plugins para un acceso doado tras a activación.
5.1
- New: Engadida a ligazón Importar/Exportar á páxina da lista de Shortcoder.
- Fix:
empty()lanzaba un erro nalgúns lugares para os usuarios con PHP 5.5 ou inferior, porque se lle pasaba o valor de retorno dunha función. - Fix: O botón QTTags de Shortcoder cargábase nas páxinas públicas.
- Fix: A ventá emerxente «Inserir shortcode» quedaba oculta detrás na páxina do personalizador do tema.
- Fix: Advertencia
array_key_existsarray but bool given. - Fix: Oculta a metabox de comentarios na páxina de edición de shortcodes, xa que se mostraba en certas condicións.
5.0.4
- Fix: Elimináronse as etiquetas
scriptestyletras a actualización a 4.x. Nesta versión executarase unha nova migración e o contido dos shortcodes quedará corrixido.
5.0.3
- Fix: O contido do shortcode non se escapa cando se usa o editor de código. É necesario porque
post_contentcompórtase de forma estraña cando o usuario ten activada a edición rica.
5.0.2
- Fix: Os shortcodes dentro do contido dun shortcode non se executaban.
- Fix: Desactivado o bloque de Gutenberg para versións antigas de WordPress non compatibles.
5.0.1
- Fix: O editor de código escapaba os caracteres HTML.
- Fix:
get_current_screen()non definido. - Fix: O editor de código falla se hai outro plugin que carga codemirror.
- Fix: Non se atopa
tools.php.
5.0
- New: Versión totalmente nova. Plugin reescrito desde cero.
- New: Bloque Shortcoder para o editor de bloques.
4.4
- New: Inserir un shortcode engade automaticamente a «etiqueta de peche» se o shortcode ten un parámetro de contido encerrado.
- Fix: Codemirror actualizouse á última versión.
4.3
- New: Edita o nome do shortcode despois de crealo.
- New: Engadido o parámetro de data de modificación da entrada.
- Fix: Os parámetros de data agora móstranse no idioma do sitio.
4.2
- Fix: Algúns plugins non lanzaban o evento JS onload porque Shortcoder o sobrescribía.
- Fix: Javascript da ventá emerxente de inserción de shortcodes non funcionaba en IE 11.
- Fix: Faltaba un paréntese ao chamar a
is_year. - Fix: A páxina de widgets non cargaba a ventá emerxente de inserción de shortcodes.
- Fix: Eliminada a icona emoji de axustes da lista de accións do plugin.
- Fix: Carga a última versión 5.42.0 de codemirror.
- Fix: Actualizada a versión mínima requirida de WordPress.
4.1.9
- Fix: Pequenos refinamentos na IU para mellorar a experiencia.
- Fix: Erro de importación onde algúns arquivos JSON exportados teñen 0 como EOF.
4.1.8
- New: Inserir campos personalizados no contido do shortcode.
- Fix: Eliminados os comentarios na saída do shortcode
4.1.7
- New: Categoriza, busca e filtra shortcodes usando «etiquetas».
- New: O último editor de shortcodes usado gardarase xunto co shortcode.
- New: O contido encerrado do shortcode agora pode usarse como parámetro do shortcode.
- New: Activouse o resaltado da liña activa no editor de código.
- Fix: Codemirror actualizouse á última versión.
- Fix: Pequenas melloras na interface de administración.
4.1.6
- New: Agora pódense engadir variables de data ao contido do shortcode.
- Fix: Xestionouse o erro «trying to get property of non-object».
4.1.5
- New: Agora pódense engadir variables de Bloginfo ao contido do shortcode.
4.1.4
- New: Editor de código do contido do shortcode con resaltado de sintaxe baseado en Codemirror (beta).
4.1.3
- Fix: Os nomes de shortcode con caracteres non permitidos non se poden editar/eliminar.
- New: As importacións de shortcodes agora poden ser novas ou sobrescribir.
- New: Só os usuarios coa capacidade
manage_optionsverán a opción «editar shortcode» na ventá de inserción. - Fix: Fallo de importación con caracteres UTF-8.
- Fix: Busca con distinción entre maiúsculas e minúsculas nas páxinas de administración.
- Fix: Pequenos cambios na interface de administración.
4.1.2
- New: Caixa de busca de shortcodes na páxina de administración.
4.1.1
- Fix: Erro HTTP 500 por un erro de sintaxe no módulo de importación.
4.1
- New: Característica de importación/exportación de shortcodes.
- Fix: O editor visual agora está desactivado por defecto.
- Fix: Engadidas instrucións na páxina de administración.
4.0.3
- New: Engadida a característica de ordenar a lista de shortcodes creados.
- Fix: Erros HTML na páxina de administración
4.0.2
- Fix: Ás veces chamábase a
get_current_screen()demasiado pronto nalgunhas configuracións.
4.0.1
- Fix: Os servidores con versión de PHP < 5.5 tiñan un erro HTTP 500 por un mal uso dunha construción da linguaxe PHP no código.
4.0
- New: Plugin reescrito desde cero.
- New: Páxina de administración totalmente nova
- New: Axustes de visibilidade do shortcode, mostrar/ocultar en ordenador/dispositivos móbiles
- New: Inserir información de WordPress no contido do shortcode.
- Fix: A ventá de inserción de shortcodes non cargaba.
- Fix: Non se puideron eliminar os shortcodes
(Os rexistros de cambios máis antigos elimináronse desta lista)
