SPIP

[ar] [ast] [bg] [br] [ca] [co] [cpf] [cs] [da] [de] [en] [eo] [es] [eu] [fa] [fon] [fr] [gl] [id] [it] [ja] [lb] [nl] [oc] [pl] [pt] [ro] [ru] [sk] [sv] [tr] [uk] [vi] [zh] Espace de traduction

Descargar

El bucle ARTICLES (artículos)

Mayo de 2003 — mis à jour le : Marzo de 2011

Todas las versiones de este artículo:


Un bucle de artículos se codifica poniendo ARTICLES (con una «s») entre paréntesis:

Los elementos contenidos en tal bucle son artículos.

Nota. Un bucle ARTICLES sólo devuelve artículos publicados. (No hay ninguna manera de mostrar artículos «en curso de redacción», «propuestos a la publicación» o «rechazados».)

Los criterios de selección

Se utilizará uno de los criterios siguientes para indicar cómo se seleccionan los elementos.

-  {tout} (todo) se selecciona la totalidad de los artículos del sitio (en todas las secciones). Útil en particular para mostrar los artículos más recientes (de la totalidad del sitio) en la portada [En realidad, el criterio «tout» no se procesa de manera informática: es un «recordatorio» para la webmestre; se obtiene el mismo resultado si no se indica ninguno de los criterios siguientes.].

-  {id_article} devuelve el artículo cuyo identificador es id_article. Como el identificador de cada artículo es único, este criterio devuelve una respuesta o ninguna.

-  {id_rubrique} devuelve la lista de artículos contenidos en la sección id_rubrique.

-  {id_secteur} devuelve los artículos de este sector (un sector es una sección que no depende de ninguna otra sección, es decir situada en la raíz del sitio).

-  [SPIP 1.4] {branche} : el criterio {branche} (rama) devuelve el conjunto de artículos de la sección y de sus sub-secciones. (Es una especie de extensión del criterio {id_secteur}. Sin embargo, al contrario de {id_secteur=2}, no es posible llamar directamente una branche, por ejemplo con {branche=2}: hablando técnicamente, es necesario que la sección en cuestión esté en el contexto actual. Este criterio se debe usar con moderación: si tu sitio está bien estructurado, no deberías necesitarlo, salvo en casos muy particulares.)

-  {id_auteur} devuelve los artículos correspondientes a este identificador de autor (útil para indicar la lista de artículos escritos por un autor).

-  {id_mot} devuelve los artículos correspondientes a este identificador de palabra clave (útil para indicar la lista de los artículos que tratan de cierto tema).

-  [SPIP 1.3] {titre_mot=xxxx}, o {type_mot=yyyy} devuelve los artículos asociados con la palabra clave cuyo nombre es «xxxx», o unidos a las palabras clave del grupo de palabras clave «yyyy». Cuidado, no se pueden utilizar varios criterios {titre_mot=xxxx} o {type_mot=yyyy} en un mismo bucle.

-  [SPIP 1.4] {id_groupe=zzzz} permite seleccionar los artículos ligados a un grupo de palabras clave, principio idéntico al criterio {type_mot} precedente; pero, como trabajamos con un identificador (número del grupo), la sintaxis será más «limpia». [Nota: Este criterio no es (en el estado actual del desarrollo de SPIP) acumulable con el precedente {type_mot=yyyy}]

-  [SP<font color="yellow">IP 1.7.1] {lang} selecciona los artículos del idioma solicitado en la dirección de la página.

-  [SP<font color="yellow">IP 1.7.2] Los criterios {date} (o {date=...} o {date==...}) permiten seleccionar un artículo en función de la fecha pasada en la URL.

-  {recherche} devuelve los artículos correspondientes a las palabras indicadas en la interfaz de búsqueda. (motor de búsqueda incorporado en SPIP). Ver la página dedicada al motor de búsqueda.

El estado del artículo

Como todos los bucles de SPIP, un bucle ARTICLES sólo devuelve artículos publicados; en caso de que el sitio esté ajustado de forma que no se publiquen los artículos con «fecha de publicación posterior», se realiza otra comprobación con la fecha del artículo. Hasta [SPIP 1.8.2] no existía ninguna manera de detener esa comprobación para mostrar los artículos «en proceso de redacción», «propuestos para publicación» o «rechazados». Ahora se puede hacer gracias al criterio {statut}:

-  {statut=prop/prepa/publie/refuse/poubelle} [SPIP 1.8.2] selecciona los artículos en función de su estado de publicación:

  • {statut=prepa} son los artículos en proceso de redacción en el espacio privado;
  • {statut=prop} son los artículos propuestos para su publicación;
  • {statut=publie} son los artículos publicados en el sitio Web, incluyendo los que tienen «fecha de publicación posterior»;
  • {statut=refuse} son los artículos cuya publicación se ha rechazado,
  • {statut=poubelle} son los artículos que se han enviado a la papelera.

Los criterios de presentación

Una vez fijado uno de estos criterios, se podrán agregar los criterios siguientes para restringir el número de elementos seleccionados.

-  Por supuesto, se aplican los criterios comunes a todos los bucles.

-  {exclus} (excluido) permite excluir del resultado el artículo en el cual ya nos encontramos (por ejemplo, cuando se muestran los artículos contenidos en la misma sección, no se quiere que aparezca un enlace hacia el artículo en el cual estamos ya).

Las balizas de este bucle

Las balizas extraídas de la base de datos

Las balizas siguientes corresponden a los elementos directamente extraídos de la base de datos. Puedes utilizarlos igualmente como criterio de clasificación (por ejemplo: {par date} o {par titre}).

-  #ID_ARTICLE muestra el identificador único del artículo. Útil para fabricar enlaces de hipertexto no previstos (por ejemplo hacia una página «Ver en formato para impresión»).

-  #SURTITRE devuelve el antetítulo.

-  #TITRE devuelve el título del artículo.

-  #SOUSTITRE devuelve el subtítulo.

-  #DESCRIPTIF devuelve la descripción.

-  #CHAPO devuelve el texto de introducción (epígrafe, entradilla, copete, como sea que se lo llame).

-  #TEXTE devuelve el texto principal del artículo.

-  #PS devuelve la posdata del artículo (post-scriptum).

-  Las fechas : #DATE, #DATE_REDAC, #DATE_MODIF están explicadas en la documentación sobre «La gestión de las fechas».

-  #ID_RUBRIQUE es el identificador de la sección de la cual depende el artículo.

-  #ID_SECTEUR es el identificador del sector del cual depende el artículo (siendo el sector la sección situada en la raíz del sitio).

-  #NOM_SITE y #URL_SITE corresponden a los campos del «enlace de hipertexto» del artículo (si es que has activado esta opción).

-  #VISITES es el número de visitas de este artículo.

-  #POPULARITE da el porcentaje de popularidad de este artículo, ver la documentación acerca de La popularidad de los artículos.

-  #LANG devuelve el idioma de este artículo.

Las balizas calculadas por SPIP

Los elementos siguientes son calculados por SPIP. (No pueden ser utilizados como criterio de clasificación.)

-  #NOTES las notas de fin de página (calculadas a partir del análisis del texto).

-  #INTRODUCTION: [SPIP 1.4] si el artículo contiene una descripción, esta se utiliza aquí; si no, SPIP muestra los 600 primeros caracteres del inicio del artículo (del epígrafe, y luego del texto). [SPIP 1.3] En las versiones precedentes de SPIP, son siempre los primeros caracteres del artículo (epígrafe, y luego el texto) los que se tienen en cuenta (la descripción no se utiliza).

-  #LESAUTEURS las autoras de este artículo. Evita tener que crear un bucle AUTEURS para obtener el mismo resultado.

-  #PETITION el texto de la petición si existe. Si existe pero no tiene texto, devuelve un espacio (una cadena no vacía sin incidencia en una página HTML).

-  #URL_ARTICLE es la URL de la página del artículo.

-  #FORMULAIRE_FORUM fabrica la interfaz que permite colgar un mensaje de respuesta a este artículo. Para saber más, ver también «Los formularios».

-  #FORMULAIRE_SIGNATURE crea la interfaz que permite firmar la petición asociada con este artículo.

-  #PARAMETRES_FORUM fabrica la lista de variables utilizadas por la interfaz del formulario que permite responder a este artículo. Por ejemplo:
-  [<A HREF="forum.php3?(#PARAMETRES_FORUM)">Responder a este artículo</A>]

Los logos

-  #LOGO_ARTICLE el logo del artículo, eventualmente con la gestión del sobrevuelo por el ratón.

-  #LOGO_ARTICLE_RUBRIQUE el logo del artículo, eventualmente reemplazado por el logo de la sección si no existe un logo específico del artículo.

-  #LOGO_RUBRIQUE el logo de la sección del artículo.

Los logos se incorporan en un esqueleto SPIP de la manera siguiente:

[(#LOGO_ARTICLE|alineación|dirección)]

La alineación puede ser left (izquierda) o right (derecha). La dirección es la URL de destino del enlace de este logo (por ejemplo #URL_ARTICLE). Si no se indica una dirección, el botón no es un enlace.

Si se quiere recuperar directamente el nombre del fichero de logo (mientras que las balizas precedentes fabrican el código HTML completo para insertar la imagen en la página), por ejemplo para mostrar una imagen como fondo de un cuadro, se utilizará el filtro |fichier como sigue: [(#LOGO_ARTICLE|fichier)]

Por otra parte, hay dos balizas que permiten recuperar uno solo de los dos logos :
-  #LOGO_ARTICLE_NORMAL es el logo principal;
-  #LOGO_ARTICLE_SURVOL es el segundo logo, que normalmente aparece cuando se lo «sobrevuela» con el ratón.


Ver el esqueleto de esta página Sitio desarrollado con SPIP | Espace de traduction | Espacio privado