WordPress.org

Codex

es:Referencia de Funciones/add post meta

Contents

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

$post_id
(integer) (required) El ID del post al que queremos añadir un campo presonalizado.
Default: None
$meta_key
(string) (required) La clave del campo personalizado que usted va a añadir.
Default: None
$meta_value
(string) (required) El valor del campo personalizado que usted va a añadir.
Default: None
$unique
(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: false

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)

See also index of Function Reference and index of Template Tags.