Cyr-To-Lat

FAQ

¿Cómo puedo definir mis propias sustituciones?

Añade este código al archivo functions.php de tu 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' );

¿Cómo puedo redefinir una configuración regional no estándar?

Por ejemplo, si tu configuración regional no estándar es uk_UA, puedes redefinirla como uk añadiendo el siguiente código al archivo functions.php de tu 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' );

¿Cómo puedo definir mi propia transliteración de títulos?

Añade un código similar al archivo functions.php de tu 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 );

¿Cómo puedo controlar el puente heredado de sanitize_title?

La versión 7.0 utiliza controladores de slug explícitos para entradas, términos, atributos de WooCommerce y otras rutas de guardado conocidas. Un puente heredado de sanitize_title permanece como alternativa de compatibilidad para llamadas generales en las que las integraciones más antiguas puedan seguir confiando.

Puedes desactivar la alternativa general con este código:

add_filter( 'ctl_enable_legacy_sanitize_title_bridge', '__return_false' );

El filtro recibe el valor predeterminado actual, $title, $raw_title y $context. Los contextos conocidos explícitos, como el manejo de guardado de WordPress, siguen usando las rutas de slug dedicadas de la versión 7.0.

Para depurar llamadas de puente desconocidas, define CYR_TO_LAT_DEBUG_LEGACY_SANITIZE_TITLE_BRIDGE como true. Este registro de diagnóstico está desactivado por defecto y no se activa con WP_DEBUG.

¿Cómo puedo definir mi propia transliteración de nombres de archivo?

Añade un código similar al archivo functions.php de tu 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 );

¿Cómo puedo permitir que el plugin funcione en el frontend?

Añade el siguiente código al archivo principal de tu plugin (o mu-plugin). Este código no funcionará si se añade al archivo functions.php de un 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' );

¿Cómo puedo limitar los tipos de contenido para la conversión en segundo plano?

Añade un código similar al archivo functions.php de tu 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' );

¿Cómo puedo convertir muchas entradas/términos usando wp-cli?

Usa el siguiente comando en la consola:

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

Donde
-post_type es una lista de tipos de contenido,
-post_status es una lista de estados de las entradas.

¿Qué comportamiento de los atributos de WooCommerce es compatible en la versión 7.0?

Cyr-To-Lat 7.0 gestiona explícitamente los slugs de productos nuevos y actualizados de WooCommerce, los slugs de categorías y etiquetas de productos, los slugs de atributos globales, los slugs de términos de atributos globales, las claves de atributos locales de productos, las claves de atributos de variación, las solicitudes de añadir al carrito desde el frontend, la carga de sesiones del carrito, los guardados mediante REST/API y los flujos de guardado del administrador.

Los atributos existentes de WooCommerce no se migran automáticamente durante la actualización del plugin. Esto significa que las taxonomías globales pa_* existentes, las claves de atributos locales de productos y las claves de atributos de variación mantienen sus valores almacenados actuales hasta que los cambies intencionadamente. Una futura herramienta de migración debería ser independiente y ejecutarse primero en modo de simulación para que los propietarios de las tiendas puedan revisar el impacto antes de cualquier reescritura.

¿Cómo puedo regenerar miniaturas de forma segura?

La regeneración de miniaturas con el comando wp media regenerate puede romper enlaces en entradas antiguas, ya que los nombres de archivo se transliteran.

Para evitarlo, desactiva el plugin cyr2lat durante la regeneración:

wp media regenerate --skip-plugins=cyr2lat

¿Puedo contribuir?

¡Sí, puedes!

• Únete a nuestro repositorio de GitHub
• Únete a nuestro grupo de Telegram

¿Dónde puedo informar de los errores de seguridad encontrados en este plugin?

Informa de las vulnerabilidades de seguridad por correo electrónico a:

security@kagg.eu

Al informar de una vulnerabilidad, incluye toda la información posible para ayudarnos a reproducir e investigar el problema, como:

• Una descripción clara de la vulnerabilidad
• Pasos para reproducir
• Código de prueba de concepto o exploit (si está disponible)
• Versiones afectadas

Revisaremos tu informe y responderemos lo antes posible.