Help us to improve the Codex by filling out our documentation survey!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)
