Es:Referencia de Funciones/add post meta

来自WordPress中文文档
跳转至: 导航搜索

Descripción

add_post_meta añade un campo meta personalizado a un post especificado, (o página).

Si el parámetro $unique se establece a true y la clave meta especificada ya existe, la función devuelve false y no hace cambios; si no, devuelve true.

Uso

%%% <?php add_post_meta($post_id, $meta_key, $meta_value, $unique); ?> %%%

Parámetros

tt$post_id/tt
(integer) (required) El ID del post al que queremos añadir un campo presonalizado.
Default: Nonenoinclude

div class=template-description style=padding: 0 1.5em; border: 1px solid #eeeeee; background-color: #f9f9f9

Notes

This template is for standardizing how parameters look in the Function Reference and in Template Tags. Here is an example of this template being called: prenowiki检查到模板循环:模板:Parameter/nowiki/pre 检查到模板循环:模板:Parameter

The usage of this template is below: prenowiki检查到模板循环:模板:Parameter/nowiki/pre Let's take a closer look at the parameters..

name
The name of the parameter.
datatype
The datatype that should be given for this parameter when called.
  • string
  • integer
  • boolean
  • mixed
description
A short description of the parameter.
importance
Set this parameter to optional if the parameter is optional. Otherwise, do not declare this parameter—it defaults to required.
  • required
  • optional
default
If this parameter is optional, ttdefault/tt is the value that will be used if the parameter is not declared.

wordpress.org.cn /div /noinclude

tt$meta_key/tt
(string) (required) La clave del campo personalizado que usted va a añadir.
Default: Nonenoinclude

div class=template-description style=padding: 0 1.5em; border: 1px solid #eeeeee; background-color: #f9f9f9

Notes

This template is for standardizing how parameters look in the Function Reference and in Template Tags. Here is an example of this template being called: prenowiki检查到模板循环:模板:Parameter/nowiki/pre 检查到模板循环:模板:Parameter

The usage of this template is below: prenowiki检查到模板循环:模板:Parameter/nowiki/pre Let's take a closer look at the parameters..

name
The name of the parameter.
datatype
The datatype that should be given for this parameter when called.
  • string
  • integer
  • boolean
  • mixed
description
A short description of the parameter.
importance
Set this parameter to optional if the parameter is optional. Otherwise, do not declare this parameter—it defaults to required.
  • required
  • optional
default
If this parameter is optional, ttdefault/tt is the value that will be used if the parameter is not declared.

wordpress.org.cn /div /noinclude

tt$meta_value/tt
(string) (required) El valor del campo personalizado que usted va a añadir.
Default: Nonenoinclude

div class=template-description style=padding: 0 1.5em; border: 1px solid #eeeeee; background-color: #f9f9f9

Notes

This template is for standardizing how parameters look in the Function Reference and in Template Tags. Here is an example of this template being called: prenowiki检查到模板循环:模板:Parameter/nowiki/pre 检查到模板循环:模板:Parameter

The usage of this template is below: prenowiki检查到模板循环:模板:Parameter/nowiki/pre Let's take a closer look at the parameters..

name
The name of the parameter.
datatype
The datatype that should be given for this parameter when called.
  • string
  • integer
  • boolean
  • mixed
description
A short description of the parameter.
importance
Set this parameter to optional if the parameter is optional. Otherwise, do not declare this parameter—it defaults to required.
  • required
  • optional
default
If this parameter is optional, ttdefault/tt is the value that will be used if the parameter is not declared.

wordpress.org.cn /div /noinclude

tt$unique/tt
(boolean) (optional) Si usted quiere o no que la clave sea única. Cuando se establece true, esto asegurará que no existe ya un campo personalizado adjunto a este post con $meta_key como su clave, y, si este campo ya existe, la clave no se añadirá.
Default: falsenoinclude

div class=template-description style=padding: 0 1.5em; border: 1px solid #eeeeee; background-color: #f9f9f9

Notes

This template is for standardizing how parameters look in the Function Reference and in Template Tags. Here is an example of this template being called: prenowiki检查到模板循环:模板:Parameter/nowiki/pre 检查到模板循环:模板:Parameter

The usage of this template is below: prenowiki检查到模板循环:模板:Parameter/nowiki/pre Let's take a closer look at the parameters..

name
The name of the parameter.
datatype
The datatype that should be given for this parameter when called.
  • string
  • integer
  • boolean
  • mixed
description
A short description of the parameter.
importance
Set this parameter to optional if the parameter is optional. Otherwise, do not declare this parameter—it defaults to required.
  • required
  • optional
default
If this parameter is optional, ttdefault/tt is the value that will be used if the parameter is not declared.

wordpress.org.cn /div /noinclude

Ejemplos

Uso por Defecto

<?php add_post_meta(68, 'my_key', 47); ?>

Añadiendo o Actualizando un Unico Campo

Añade un nuevo campo si la clave no existe, o actualiza el campo que ya existe. (ACTUALIZACION: Si el cuarto parámetro de add_post_meta se establece como true, el campo no se actualizará is ya existe (comprobado en WP 2.6.2). Utilice if (!update_post_meta(...)) add_post_meta(...)).

 <?php add_post_meta(7, 'fruit', 'banana', true) o update_post_meta(7, 'fruit', 'banana'); ?>

Otros Ejemplos

Si usted quiere asegurarse de que no existen campos con la clave "my_key", anes de añadirla:

<?php add_post_meta(68, 'my_key', '47', true); ?>

Para añadir varios valores a la clave "my_key":

<?php add_post_meta(68, 'my_key', '47'); ?>
<?php add_post_meta(68, 'my_key', '682'); ?>
<?php add_post_meta(68, 'my_key', 'The quick, brown fox jumped over the lazy dog.'); ?>
...

Para un ejemplo más detallado, consulte la página Ejemplos de la función post_meta.

Creando un Custom Field Oculto

Si usted es un desarrollador de plugin/plantillas y planea utilizar custom fields para almacenar parámetros relativos a su plugin o plantilla, es interesante saber que WordPress no mostrará claves que empiecen con un "_" (subrayado) en la lista de campos en la página de edición de post/páginas. Dicho ésto, es una buena práctica utilizar un subrayado como primer carácter sus parámetros personalizados. De esta manera sus configuraciones se almacenarán como custom fields, pero no se mostrarán en la lista de custom fields en el interface de usuario.

El siguiente ejemplo:

<?php add_post_meta(68, '_color', 'red', true); ?>

añadirá un custom field único con el nombre "_color" y el valor "red" pero este custom fields no será mostrado en la página de edición de páginas/post.

Relacionados

Custom Fields: the_meta, get_post_meta, add_post_meta, update_post_meta, delete_post_meta, get_post_custom, get_post_custom_values, get_post_custom_keys (See Also: post_meta Function Examples)

includeonlydiv style=clear:both; background-color:#F7F7F7; border:1px solid #CCCCCC; color:#000000; padding:7px; margin:0.5em auto 0.5em auto; vertical-align:middle;See also index of Function Reference and index of Template Tags./div/includeonlynoinclude

Description

This Template is used by Codex:Template Messages.

Usage

pre 检查到模板循环:模板:Message /pre

Result

检查到模板循环:模板:Message

/noinclude