WPML
apply_filters( 'wpml_duplicate_generic_string', string $value_to_filter, string $target_language, array $meta_data )
Tipo
filter
Categoria
Diversos
Versão do WPML
3.2

Descrição

O WPML aplica este filtro de hook nos valores de campos personalizados, no conteúdo do post, no título do post e no resumo do post quando um tipo de post do WordPress está sendo duplicado e antes que os dados sejam salvos no banco de dados. Dessa forma, os dados são disponibilizados a temas e plugins externos para filtragem.

Argumentos

$value_to_filter
(string) (Obrigatório) A string de dados a ser filtrada
$target_language
(string) (Opcional) O código do idioma de destino
$meta_data
(array) (Opcional) Veja os detalhes abaixo:
  • context(string) O contexto dos dados. Defina como “custom_field” se o valor pertencer a um campo personalizado e “post” para todos os outros casos (título, conteúdo ou resumo do post)
  • attribute(string) Defina como: “value” para campos personalizados, “content” para o conteúdo do post, “title” para o título do post, “excerpt” para o resumo do post
  • key(string) A $post_meta->meta_key se o filtro estiver sendo aplicado a valores de campos personalizados. Caso contrário, o ID do post original que atua como principal para a duplicação
  • $is_serialized(bool) Passado apenas para dados de campos personalizados. true|false Se os dados estão serializados. Isso permite desserializar o valor, se necessário.
  • post_id(int) Passado apenas para dados de campos personalizados. O ID do post que está sendo duplicado
  • master_post_id(int) Passado apenas para dados de campos personalizados. O ID do post original que atua como principal para a duplicação

Exemplo de uso

Um exemplo básico
function my_override_post_duplication( $value_to_filter, $target_language, $meta_data ) {
    $context = $meta_data[ 'context' ];
    if ( $value_to_filter !== '' && $context ) {
        $prefix = '';

        $attribute = $meta_data[ 'attribute' ];
        if ( $context == 'post' ) {
            switch ( $attribute ) {
                case 'content':
                    $prefix = '<h3>' . $target_language . '</h3>';
                    break;
                case 'excerpt':
                    $prefix = $target_language . "nn";
                    break;
                default:
                    $prefix = '[' . $target_language . '] ';
            }
        } elseif ( $context == 'custom_field' && $attribute == 'value' ) {
            $is_serialized = $meta_data[ 'is_serialized' ];
            if ( ! $is_serialized && is_string( $value_to_filter ) && ! is_numeric( $value_to_filter ) ) {
                $prefix = '[' . $target_language . '] ';
            }
        }

        if($prefix) {
            $value_to_filter = $prefix . $value_to_filter;
        }
    }

    return $value_to_filter;
}

add_filter( 'wpml_duplicate_generic_string', 'my_override_post_duplication', 10, 3 );

icl_ls_languages, wpml_sync_custom_field_copied_value, wpml_ls_enable_ajax_navigation, wpml_element_type, wpml_setting, wpml_sub_setting, wpml_exclude_post_from_auto_translate, wpml_forms_config_ninja-forms, wpml_forms_config_wpforms, wpml_tf_feedback_open_link

Todos os 30 hooks de Diversos →