Descripción
Para una mejor compatibilidad del archivo «README.md», los campos bajo el título del plugin, «Contributors», «Tags», etc., deben estar en un formato similar al de este ejemplo de archivo «readme». Esto significa que no debe haber caracteres después de «:» aparte del valor, sin formato, solo un valor y una nueva línea.
Esta es la descripción larga. Sin límite y puedes usar Markdown (así como en las siguientes secciones).
Para compatibilidad con versiones anteriores, si falta esta sección, se usará la longitud completa de la descripción corta y
el análisis de Markdown.
Algunas notas sobre las secciones anteriores:
- «Contributors» es una lista separada por comas de nombres de usuario de wp.org o wp-plugins.org
- «Tags» es una lista separada de etiquetas que se aplican al plugin
- «Requires at least» es la versión más baja en la que funcionará el plugin
- «Tested up to» es la versión más alta que has usado correctamente para probar el plugin. Ten en cuenta que puede funcionar
en versiones más altas… esta es solo la versión más alta que has verificado. -
La etiqueta «Stable» debe indicar la «etiqueta» de Subversion de la última versión estable, o «trunk», si usas
/trunk/
para la
versión estable.Ten en cuanta que el archivo
readme.txt
de la etiqueta estable es el que se considera que define al plugin, así que,
si el archivo/trunk/readme.txt
dice que la etiqueta estable es4.3
, entonces es/tags/4.3/readme.txt
el que se usará
para mostrar la información sobre el plugin. En esta situación, lo único que se considera del archivoreadme.txt
de «trunk»
es el indicador de la etiqueta estable. Por tanto, si desarrollas en «trunk», puedes actualizar el archivoreadme.txt
de «trunk» para reflejar los cambios en
tu versión en desarrollo, sin tener esa información mostrada incorrectamente sobre la versión estable actual
que carece de esos cambios, siempre y cuando el archivoreadme.txt
de «trunk» apunte a la etiqueta estable correcta.Si no se proporciona una etiqueta estable, se asume que «trunk» es estable, pero debes especificar «trunk» si es ahí donde
pones la versión estable, para eliminar cualquier duda.
Probando algunos fallos de Markdown:
Ejemplos:
define( ‘TC_PRE’, ‘Theme Review:[[br]]
– Los temas deben ser revisados usando «define(\’WP_DEBUG\’, true);» en el archivo «wp-config.php»[[br]]]
– Los temas deben ser revisados usando los datos de prueba de las listas de comprobación de temas (TC)
—–
‘ );
define( 'TC_POST', 'Feel free to make use of the contact details below if you have any questions,
comments, or feedback:[[br]]
[[br]]
* Leave a comment on this ticket[[br]]
* Send an email to the Theme Review email list[[br]]
* Use the #wordpress-themes IRC channel on Freenode.' );
three backtics:
add_action( 'init', function() {
// do stuff
} );
or indents
add_action( ‘init’, function() {
// do stuff
} );
Sección arbitraria
You may provide arbitrary sections, in the same format as the ones above. This may be of use for extremely complicated
plugins where more information needs to be conveyed that doesn’t fit into the categories of «description» or
«installation.» Arbitrary sections will be shown below the built-in sections outlined above.
Un breve ejemplo de Markdown
Ordered list:
- Alguna característica
- Otra característica
- Algo más sobre el plugin
Unordered list:
- algo
- algo más
- tercera cosa
Here’s a link to WordPress and one to Markdown’s Syntax Documentation.
Titles are optional, naturally.
Markdown uses email style notation for blockquotes and I’ve been told:
Asterisks for emphasis. Double it up for strong.
<?php code(); // goes in backticks ?>
Capturas
Bloques
Este plugin proporciona 4 bloques.
- Namespace Block Name
- Title here
- Title here
- Title here
Instalación
This section describes how to install the plugin and get it working.
Ejemplo:
- Upload
plugin-name.php
to the/wp-content/plugins/
directory - Activa el plugin a través del menú «Plugins» en WordPress
- Place
<?php do_action('plugin_name_hook'); ?>
in your templates
FAQ
-
A question that someone might have
-
An answer to that question.
-
What about foo bar?
-
Answer to foo bar dilemma.
-
Markdown 1
-
`body, h1, p {
color: #f1f1f1 !important;
} -
wpwrap {
-
background-color: #5f5f5f !important;
}` -
Markdown 2
- wpwrap {
background-color: #5f5f5f !important; } body, h1, p { color: #f1f1f1 !important; }
Reseñas
Colaboradores y desarrolladores
«Test Plugin 3 – Testing plugin» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores«Test Plugin 3 – Testing plugin» está traducido en 8 idiomas. Gracias a los traductores por sus contribuciones.
Traduce «Test Plugin 3 – Testing plugin» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.0
- A change since the previous version.
- Another change.
- Another change this time that means something.
- Una línea del registro de cambios para probar https://meta.trac.wordpress.org/changeset/8412