Sí. Es posible añadir tus propios marcadores de posición para insertar automáticamente contenido en tus publicaciones sociales desde campos personalizados o incluso usando funciones personalizadas.
Veamos cómo agregar marcadores de posición personalizados en los mensajes sociales.
Cómo agregar campos personalizados en los mensajes sociales
Si quieres ampliar los marcadores de posición que puedes usar en el contenido de los mensajes sociales con valores de campos personalizados, usa el filtro nelio_content_supported_post_metas :
add_filter( 'nelio_content_supported_post_metas', function( $metas, $post_type ) {
if ( $post_type !== 'post' ) {
return $metas;
}
return array(
array(
'key' => 'my-custom-field',
'name'=> 'My custom field',
),
array(
'key' => 'another-custom-field',
'name'=> 'Another custom field',
)
);
}, 10, 2 );Este filtro recibe una serie de campos personalizados admitidos (también conocidos como post metas) que puedes ampliar agregando tus propios campos personalizados. Ten en cuenta que cada elemento de la lista debe tener dos propiedades: key y name.
La key de un campo personalizado es el valor de la columna meta_key en la tabla wp_postmeta. El name del campo personalizado es la etiqueta que verás en el editor de mensajes sociales cuando hagas clic en el icono Agregar marcador de posición para ver los marcadores de posición disponibles:
Aparecerá una nueva sección llamada Campos Personalizados con los campos personalizados incluidos con el filtro nelio_content_supported_post_metas. Cuando selecciones el campo personalizado que deseas agregar, se incluirá un nuevo marcador de posición en el contenido del mensaje social con la estructura {field:key}, como puedes ver en la imagen anterior con {filter:my-custom-field}.
Ten en cuenta que el filtro también pasa el tipo de contenido como parámetro para que puedas personalizar qué campos personalizados amplían cada tipo de contenido en WordPress. En el ejemplo de código anterior, solo ampliamos los campos personalizados admitidos para entradas (posts, en inglés).
Cómo agregar campos personalizados de Advanced Custom Fields en mensajes sociales
Si utilizas el plugin Advanced Custom Fields (ACF) para gestionar tus campos personalizados, puedes usar el filtro nelio_content_supported_post_metas de la misma manera que se explicó en la sección anterior.
De hecho, la key del campo personalizado es la clave que configuraste en ACF. Para la propiedad name, puedes usar la función get_field_object para recuperar la etiqueta del campo personalizado que definiste en ACF.
add_filter( 'nelio_content_supported_post_metas', function( $metas, $post_type ) {
if ( $post_type !== 'post' ) {
return $metas;
}
return array(
array(
'key' => 'my_acf_field',
'name'=> get_field_object( 'field_63ecb54a7bc26' )['label'],
)
);
}, 10, 2 );En el ejemplo de código anterior puedes ver cómo usar el filtro nelio_content_supported_post_metas para incluir un campo de texto ACF con la clave my_acf_field.
Cómo agregar marcadores de posición personalizados en mensajes sociales
Cuando quieres ampliar los marcadores de posición con valores personalizados de un origen diferente a la tabla wp_postmeta, o necesitas preprocesar el valor por algún motivo, Nelio Content dispone del filtro nelio_content_custom_placeholders.
Este filtro es similar al filtro nelio_content_supported_post_metas, pero cada elemento de la lista necesita un tercer atributo denominado callback, que es una función que devuelve el valor del campo personalizado.
add_filter( 'nelio_content_custom_placeholders', function( $metas, $post_type, $post_id ) {
if ( $post_type !== 'post' ) {
return $metas;
}
return array(
array(
'key' => 'cp-1',
'name' => 'My first custom placeholder',
'callback' => function() { return 'The first value'; }
),
array(
'key' => 'cp-2',
'name' => 'My second custom placeholder',
'callback' => function() { return 'The second value'; }
)
);
}, 10, 3 );Esto es especialmente útil cuando el valor que deseas recuperar está almacenado en una tabla personalizada o lo necesitas construir dinámicamente en PHP.
Aparecerá una nueva sección llamada Marcadores de posición personalizados con los marcadores de posición personalizados incluidos con el filtro nelio_content_custom_placeholders{custom:key}, como puedes ver en la imagen anterior con {custom:cp-1}.
Ten en cuenta que el valor de ese marcador de posición se puede ver en la vista previa del mensaje y se actualizará cada vez que guardes la publicación en el editor de WordPress.