Polylang with your theme 11.12.25

Where to translate the strings:

After adding the pll_register_string code and reloading the WP admin, go to WordPress admin → Languages → String translations (Polylang) and you’ll see the registered strings grouped by the group you used ("Theme" in the examples). Add translations for each language there.

Notes & tips

Always wrap Polylang calls with function_exists('pll_register_string') / pll__ to avoid fatal errors when Polylang is not active.
    The first parameter of pll_register_string in my examples is the "name/key" shown in admin; the second is the actual source string. The optional 4th parameter (true/false) marks it multiline.
    For strings that change (theme options or customizer values), re-register them on save so admin sees the updated source string.
    If you use gettext (.po/.mo) translations for your theme, that’s a separate mechanism. Polylang string translations are editable in the WP admin and are useful for content and dynamic strings created in the theme.

```
<?php
// Register Polylang strings for the theme and provide safe fallbacks when Polylang is not active.

// Hook early in admin so strings are visible in "Languages → Strings translations".
add_action( 'admin_init', 'mytheme_register_polylang_strings' );
function mytheme_register_polylang_strings() {
    if ( function_exists( 'pll_register_string' ) ) {
        // Static strings
        pll_register_string( 'read-more', 'Read more', 'Theme' );
        pll_register_string( 'footer-copyright', '© %s My Company', 'Theme' );

// Example: register a theme option or customizer value as a string
        $phone = get_option( 'mytheme_phone', '1-800-555-0123' );
        pll_register_string( 'header-phone', $phone, 'Theme' );

// If you store multiline text or long HTML, set $multiline = true:
        // pll_register_string( 'footer-html', '<strong>My HTML footer</strong>', 'Theme', true );
    }
}

// When theme options change, re-register that option so Polylang sees the latest value.
// Replace 'mytheme_options' with your actual option name if you use one.
add_action( 'update_option_mytheme_options', 'mytheme_reregister_option_strings', 10, 3 );
function mytheme_reregister_option_strings( $old_value, $value, $option ) {
    if ( function_exists( 'pll_register_string' ) && isset( $value['phone'] ) ) {
        pll_register_string( 'header-phone', $value['phone'], 'Theme' );
    }
}

// Helper that returns a translated string or a fallback if Polylang is not active.
if ( ! function_exists( 'mytheme_pll' ) ) {
    function mytheme_pll( $string ) {
        if ( function_exists( 'pll__' ) ) {
            return pll__( $string );
        }
        // Fallback: return original string (you could also run it through __() with a textdomain)
        return $string;
    }
}

<?php
// Use pll__() (returns translated string) or pll_e() (echoes translated string).
// Use the helper for a safe fallback when Polylang isn't active.

echo '<a class="read-more" href="' . esc_url( get_permalink() ) . '">';
echo esc_html( mytheme_pll( 'Read more' ) );
echo '</a>';

// Example with formatting:
printf(
    '<p class="site-credit">' . esc_html( mytheme_pll( '© %s My Company' ) ) . '</p>',
    esc_html( get_bloginfo( 'name' ) )
);

// Example showing a theme option registered as a string:
$phone = function_exists( 'pll__' ) ? pll__( get_option( 'mytheme_phone', '1-800-555-0123' ) ) : get_option( 'mytheme_phone', '1-800-555-0123' );
echo '<div class="header-phone">' . esc_html( $phone ) . '</div>';

<?php
add_action( 'wp_enqueue_scripts', 'mytheme_enqueue_scripts' );
function mytheme_enqueue_scripts() {
    wp_enqueue_script( 'mytheme-main', get_template_directory_uri() . '/js/main.js', array( 'jquery' ), '1.0', true );

// Prepare translated strings for JS. Use pll__() when available.
    $strings = array(
        'readMore' => function_exists( 'pll__' ) ? pll__( 'Read more' ) : 'Read more',
        'loading'  => function_exists( 'pll__' ) ? pll__( 'Loading...' ) : 'Loading...',
        'phone'    => function_exists( 'pll__' ) ? pll__( get_option( 'mytheme_phone', '' ) ) : get_option( 'mytheme_phone', '' ),
    );

wp_localize_script( 'mytheme-main', 'MyThemeL10n', $strings );
}
```

https://polylang.pro/how-to-easily-translate-your-wordpress-theme-a-step-by-step-guide/

Anonymous

```
<?php
/**
 * Helper: Get all Polylang strings that are missing translations.
 *
 * Usage:
 *   $missing = plat_get_polylang_missing_translations();
 *   foreach ( $missing as $item ) {
 *     // $item = [
 *     //   'string_id'   => int|string,
 *     //   'name'        => string|null,
 *     //   'source_lang' => string|null,
 *     //   'source_text' => string|null,
 *     //   'existing'    => [ 'en' => 'Hello', 'fr' => 'Bonjour' ],
 *     //   'missing'     => [ 'de', 'es' ],
 *     //   'raw'         => mixed // original raw row/object from Polylang
 *     // ]
 *   }
 *
 * Place this file inside a plugin or your theme's functions.php (recommended: plugin).
 */

if ( ! function_exists( 'plat_get_polylang_missing_translations' ) ) {
	function plat_get_polylang_missing_translations() {
		if ( ! function_exists( 'pll_languages_list' ) ) {
			return new WP_Error( 'no_polylang', 'Polylang not active.' );
		}

$languages = pll_languages_list( array( 'fields' => 'slug' ) );
		if ( empty( $languages ) ) {
			return new WP_Error( 'no_langs', 'No languages configured in Polylang.' );
		}

$default_lang = function_exists( 'pll_default_language' ) ? pll_default_language() : ( $languages[0] ?? null );

$results = array();

// Preferred approach: use PLL() model if present
		if ( function_exists( 'PLL' ) ) {
			try {
				$pll = PLL();
				if ( isset( $pll->model ) && method_exists( $pll->model, 'get_strings' ) ) {
					$raw_strings = $pll->model->get_strings();

foreach ( $raw_strings as $id => $row ) {
						// Normalize row values for common versions:
						$name = null;
						$source_text = null;
						$source_lang = null;

if ( is_object( $row ) ) {
							$name        = isset( $row->name ) ? $row->name : ( isset( $row->slug ) ? $row->slug : null );
							$source_text = isset( $row->string ) ? $row->string : ( isset( $row->value ) ? $row->value : null );
							$source_lang = isset( $row->lang ) ? $row->lang : null;
						} elseif ( is_array( $row ) ) {
							$name        = $row['name'] ?? null;
							$source_text = $row['string'] ?? $row['value'] ?? null;
							$source_lang = $row['lang'] ?? null;
						} else {
							// unknown shape, keep raw
						}

// get translations if method available
						$translations = array();
						if ( method_exists( $pll->model, 'get_string_translations' ) ) {
							$translations = $pll->model->get_string_translations( $id );
							if ( ! is_array( $translations ) ) {
								$translations = (array) $translations;
							}
						} else {
							// Some Polylang versions may store translations inside the raw row
							if ( is_object( $row ) && isset( $row->translations ) ) {
								$translations = (array) $row->translations;
							} elseif ( is_array( $row ) && isset( $row['translations'] ) ) {
								$translations = (array) $row['translations'];
							}
						}

$missing = array();
						$existing = array();

foreach ( $languages as $lang ) {
							// consider translation missing if not set or empty string
							if ( isset( $translations[ $lang ] ) && $translations[ $lang ] !== '' ) {
								$existing[ $lang ] = $translations[ $lang ];
							} else {
								// If source language equals target, it's not "missing" (source exists)
								if ( $lang === ( $source_lang ?: $default_lang ) ) {
									// If the source language entry is empty but there is a source_text above, consider it existing.
									if ( $source_text ) {
										$existing[ $lang ] = $source_text;
									} else {
										$missing[] = $lang;
									}
								} else {
									$missing[] = $lang;
								}
							}
						}

if ( ! empty( $missing ) ) {
							$results[] = array(
								'string_id'   => $id,
								'name'        => $name,
								'source_lang' => $source_lang ?: $default_lang,
								'source_text' => $source_text,
								'existing'    => $existing,
								'missing'     => $missing,
								'raw'         => $row,
							);
						}
					}

return $results;
				}
			} catch ( Exception $ex ) {
				// fallthrough to DB fallback
			}
		}

// Fallback: try reading typical Polylang DB tables (schemas vary by version)
		global $wpdb;
		$strings_table = $wpdb->prefix . 'pll_strings';
		$trans_table   = $wpdb->prefix . 'pll_string_translations';

$exists_strings = $wpdb->get_var( $wpdb->prepare( "SHOW TABLES LIKE %s", $strings_table ) );
		if ( $exists_strings ) {
			$rows = $wpdb->get_results( "SELECT * FROM {$strings_table}" );
			foreach ( $rows as $r ) {
				// Attempt to extract id/name/value/lang
				$id = $r->id ?? ( $r->string_id ?? null );
				$name = $r->name ?? null;
				$source_text = $r->value ?? $r->string ?? null;
				$source_lang = $r->lang ?? null;

$translations = array();

// Try to find translations row with same id
				$trans_row = null;
				if ( $wpdb->get_var( $wpdb->prepare( "SHOW TABLES LIKE %s", $trans_table ) ) ) {
					$trans_row = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM {$trans_table} WHERE string_id = %d LIMIT 1", $id ) );
				}

if ( $trans_row ) {
					// convert object to array and check language columns
					$tr_vars = (array) $trans_row;
					foreach ( $languages as $lang ) {
						// many schemas store language-specific columns named after slug; otherwise adjust here
						if ( array_key_exists( $lang, $tr_vars ) && $tr_vars[ $lang ] !== '' ) {
							$translations[ $lang ] = $tr_vars[ $lang ];
						}
					}
				}

$missing = array();
				$existing = array();
				foreach ( $languages as $lang ) {
					if ( isset( $translations[ $lang ] ) && $translations[ $lang ] !== '' ) {
						$existing[ $lang ] = $translations[ $lang ];
					} else {
						if ( $lang === ( $source_lang ?: $default_lang ) && $source_text ) {
							$existing[ $lang ] = $source_text;
						} else {
							$missing[] = $lang;
						}
					}
				}

if ( ! empty( $missing ) ) {
					$results[] = array(
						'string_id'   => $id,
						'name'        => $name,
						'source_lang' => $source_lang ?: $default_lang,
						'source_text' => $source_text,
						'existing'    => $existing,
						'missing'     => $missing,
						'raw'         => $r,
					);
				}
			}

return $results;
		}

return new WP_Error( 'unsupported', 'Could not find a supported Polylang API or DB schema. Adapt this helper for your Polylang version.' );
	}
}
```

11.12.25

Anonymous

Copilot said: I'll look up the file modules/wpml/wpml-legacy-api.php in

I'll look up the file modules/wpml/wpml-legacy-api.php in the repository to see what's inside and how to use it. I'll run a code search for that path.I couldn’t find a file at modules/wpml/wpml-legacy-api.php in the repository I inspected — please double‑check the path or paste the file if it’s local or coming from another repo. (Search results may be incomplete.)

If you want to “use” that file, here are the common, correct ways to include and reference it depending on how it’s implemented:

If the file is procedural (defines functions):

Include it once where needed:

<?php require_once plugin_dir_path( __FILE__ ) . 'modules/wpml/wpml-legacy-api.php'; // now call the functions it defines, e.g. wpml_legacy_api_function(); 2) If the file defines a namespaced class - Open the file and check its namespace and class name at the top (example possibilities): namespace PolylangStringExtractor\Modules\WPML; class WPML_Legacy_API { ... } - Use it with a use statement (put at the top of your PHP file): <?php use PolylangStringExtractor\Modules\WPML\WPML_Legacy_API; $api = new WPML_Legacy_API(); - Or instantiate with the fully qualified name: $api = new \PolylangStringExtractor\Modules\WPML\WPML_Legacy_API(); Note: the base plugin namespace used elsewhere in this repo is PolylangStringExtractor, so the module namespace is commonly something like PolylangStringExtractor\Modules\WPML, but you must confirm the exact namespace in modules/wpml/wpml-legacy-api.php. 3) If you’re trying to fix the error you reported earlier (Call to undefined method PLL_Admin::get_string()) - Determine which class/code is calling PLL_Admin::get_string(). If the caller expects a global PLL_Admin class (from Polylang core or another plugin) but your plugin uses a namespaced Admin class (\PolylangStringExtractor\Admin), you have three safe options: - Update the caller to use the namespaced class/method (preferred). - Add a small compatibility wrapper that maps the expected call to your implementation (see example below). - Ensure the real Polylang core providing PLL_Admin is loaded and matches the expected API/version. Compatibility wrapper example (adapt to your storage/API — put in a bootstrap file loaded early): <?php // Only add a minimal shim if the caller expects a global PLL_Admin class if ( ! class_exists( 'PLL_Admin' ) ) { class PLL_Admin { public function get_string( $key ) { // Adapt this to how your plugin stores/retrieves strings $strings = get_option( 'polylang_string_extractor_strings', array() ); $hash = md5( $key ); if ( isset( $strings[ $hash ] ) ) { return $strings[ $hash ]['string']; } return $key; } } } This creates a minimal PLL_Admin::get_string method so calls will stop fatalling; but prefer using the real provider or namespaced class if possible. If you paste the contents (or top lines) of modules/wpml/wpml-legacy-api.php I can tell you the exact namespace and the exact use/import line to add.

11.12.25

Anonymous

Polylang with your theme 11.12.25

Information Epoch 1766751670