Cyr-To-Lat

Preguntas frecuentes

Como podo definir as miñas propias substitucións?

Engade este código ao arquivo functions.php do teu tema:

/**
 * Modify conversion table.
 *
 * @param array $table Conversion table.
 *
 * @return array
 */
function my_ctl_table( $table ) {
   $table['Ъ'] = 'U';
   $table['ъ'] = 'u';

   return $table;
}
add_filter( 'ctl_table', 'my_ctl_table' );

Como podo redefinir un idioma non estándar?

Por exemplo, se o teu idioma non estándar é uk_UA, podes redefinilo como uk engadindo o seguinte código ao arquivo function.php do teu tema:

/**
 * Use non-standard locale.
 *
 * @param string $locale Current locale.
 *
 * @return string
 */
function my_ctl_locale( $locale ) {
    if ( 'uk_UA' === $locale ) {
        return 'uk';
    }

    return $locale;
}
add_filter( 'ctl_locale', 'my_ctl_locale' );

Como podo definir a miña propia transliteración dos títulos?

Engade un código similar ao arquivo functions.php do teu tema:

/**
 * Filter title before sanitizing.
 *
 * @param string|false $result Sanitized title.
 * @param string       $title  Title.
 *
 * @return string|false
 */
function my_ctl_pre_sanitize_title( $result, $title ) {
    if ( 'пиво' === $title ) {
        return 'beer';
    }

    return $result;
}
add_filter( 'ctl_pre_sanitize_title', 10, 2 );

Como podo controlar o bridge herdado de sanitize_title?

A versión 7.0 usa xestores de slug explícitos para entradas, termos, atributos de WooCommerce e outras rutas de gardado coñecidas. Un bridge herdado de sanitize_title mantense como alternativa de compatibilidade para chamadas xerais nas que aínda poidan apoiarse integracións máis antigas.

Podes desactivar o mecanismo alternativo xeral con este código:

add_filter( 'ctl_enable_legacy_sanitize_title_bridge', '__return_false' );

O filtro recibe o valor por defecto actual, $title, $raw_title e $context. Os contextos coñecidos explícitos, como o tratamento de gardado de WordPress, seguen a usar as rutas de slug dedicadas de 7.0.

Para depurar chamadas descoñecidas ao bridge, define CYR_TO_LAT_DEBUG_LEGACY_SANITIZE_TITLE_BRIDGE como true. Este rexistro de diagnóstico está desactivado por defecto e non se activa con WP_DEBUG.

Como podo definir a miña propia transliteración dos nomes de arquivo?

Engade un código similar ao arquivo functions.php do teu tema:

/**
 * Filter filename before sanitizing.
 *
 * @param string|false $result   Sanitized filename.
 * @param string       $filename Title.
 *
 * @return string|false
 */
function my_ctl_pre_sanitize_filename( $result, $filename ) {
    if ( 'пиво' === $filename ) {
        return 'beer';
    }

    return $result;
}
add_filter( 'ctl_pre_sanitize_filename', 10, 2 );

Como podo permitir que o plugin funcione na portada?

Engade o seguinte código ao arquivo principal do teu plugin (ou mu-plugin). Este código non funcionará se se engade ao arquivo functions.php dun tema.

/**
 * Filter status allowed Cyr To Lat plugin to work.
 *
 * @param bool $allowed
 *
 * @return bool
 */
function my_ctl_allow( bool $allowed ): bool {
    $uri = isset( $_SERVER['REQUEST_URI'] ) ?
        sanitize_url( wp_unslash( $_SERVER['REQUEST_URI'] ) ) :
        '';

    if ( 0 === strpos( $uri, '/divi-comments' ) ) {
        return true;
    }

    return $allowed;
}

add_filter( 'ctl_allow', 'my_ctl_allow' );

Como podo limitar os tipos de contido para a conversión en segundo plano?

Engade un código similar ao arquivo functions.php do teu tema:

/**
 * Filter post types allowed for background conversion.
 *
 * @param array $post_types Allowed post types.
 *
 * @return array
 */
function my_ctl_post_types( $post_types ) {
    return [
        'post'          => 'post',
        'page'          => 'page',
        'attachment'    => 'attachment',
        'product'       => 'product',
        'nav_menu_item' => 'nav_menu_item',
    ];
}
add_filter( 'ctl_post_types', 'my_ctl_post_types' );

Como podo converter moitas entradas/termos usando wp-cli?

Usa o seguinte comando na consola:

wp cyr2lat regenerate [--post_type=<post_type>] [--post_status=<post_status>]

Onde
-post_type é unha lista de tipos de contido,
-post_status é unha lista de estados de publicación.

Que comportamento dos atributos de WooCommerce é compatible na 7.0?

Cyr-To-Lat 7.0 xestiona explicitamente os slugs de produtos de WooCommerce novos e actualizados, os slugs de categorías e etiquetas de produto, os slugs de atributos globais, os slugs de termos de atributos globais, as claves de atributos locais de produto, as claves de atributos de variación, as solicitudes de engadir ao carriño na portada, a carga da sesión do carriño, os gardados por REST/API e os fluxos de gardado da administración.

Os atributos existentes de WooCommerce non se migran automaticamente durante a actualización do plugin. Isto significa que as taxonomías globais pa_* existentes, as claves de atributos locais de produto e as claves de atributos de variación manteñen os seus valores almacenados actuais ata que os cambies intencionadamente. Unha futura ferramenta de migración debería ser independente e funcionar primeiro en modo de proba (dry-run) para que os propietarios da tenda poidan revisar o impacto antes de calquera reescritura.

Como podo rexenerar miniaturas de forma segura?

A rexeneración de miniaturas co comando wp media regenerate pode romper ligazóns en entradas antigas, xa que os nomes de arquivo pasan a estar transliterados.

Para evitalo, desactiva o plugin cyr2lat durante a rexeneración:

wp media regenerate --skip-plugins=cyr2lat

Podo contribuír?

Si, podes!

• Únete ao noso repositorio de GitHub
• Únete ao noso grupo de Telegram

Onde informo dos erros de seguridade atopados neste plugin?

Informa das vulnerabilidades de seguridade por correo electrónico a:

security@kagg.eu

Ao informar dunha vulnerabilidade, inclúe a maior cantidade de información posible para axudarnos a reproducir e investigar o problema, como:

• Unha descrición clara da vulnerabilidade
• Pasos para reproducilo
• Código de proba de concepto ou de explotación (se está dispoñible)
• Versións afectadas

Revisaremos o teu informe e responderemos o antes posible.