Cyr-To-Lat

Часті питання

Як призначити свої правила для заміни?

Додайте наступний код в functions.php файл вашої теми:

/**
 * 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' );

Як я можу перевизначити нестандартну локаль?

Наприклад, якщо нестандартна мова є uk_UA, її можна перевизначити як uk додавши наступний код до файлу теми function.php:

/**
 * 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' );

Як я можу визначити власну транслітерацію назв?

Додайте подібний код до файлу functions.php вашої теми:

/**
 * 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 );

Як визначити власну транслітерацію назв файлів?

Додайте подібний код до файлу functions.php вашої теми:

/**
 * 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 );

Як я можу дозволити плагіну працювати на зовнішній частині сайту?

Додайте наступний код до основного файлу плагіна (або плагіна mu). Цей код не працюватиме, якщо його буде додано до файлу functions.php теми.

/**
 * 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' );

How can I limit post types for background conversion?

Додайте подібний код до файлу functions.php вашої теми:

/**
 * 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' );

Як конвертувати багато постів/термінів за допомогою wp-cli?

Скористайтеся наступною командою в консолі:

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

Where
-post_type is a list of post types,
-post_status is a list of post statuses.

Як я можу безпечно регенерувати мініатюри?

Регенерація мініатюр командою wp media regenerate може призвести до розриву посилань у старих публікаціях, оскільки імена файлів транслітеруються.

To avoid it, deactivate the cyr2lat plugin during regeneration:

wp media regenerate --skip-plugins=cyr2lat

Чи можу я внести свій внесок?

Так, ви можете!

• Приєднуйтесь до нашого репозитарію GitHub
• Приєднуйтеся до нашої групи Telegram

Where do I report security bugs found in this plugin?

Please report security bugs found in the source code of the undefined plugin through the Patchstack Vulnerability Disclosure  Program. The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.