GelişmişPHP Kodu ile Çeviri
PHP Kodu ile Çeviri
Uygulamanız, temanız veya eklentiniz içinde PHP kodu aracılığıyla çevirileri tetikleyebilirsiniz.
GatoStandalone\GatoAITranslationsForPolylang\Gato sınıfı, çevirileri tetiklemek için statik yöntemler sağlar:
| Yöntem | Açıklama |
|---|---|
translate | translateCustomPosts için takma ad |
translateCustomPosts | Özel gönderileri çevir (sayfalar, yazılar, özel gönderi türleri) |
translateTaxonomyTerms | Taksonomi terimlerini çevir (kategoriler, etiketler, özel taksonomiler) |
translateMedia | Medya öğelerini çevir (görseller, belgeler vb.) |
Yöntem imzası
Bu, tüm çeviri yöntemleri için yöntem imzasıdır:
Yalnızca ids parametresi zorunludur. Sağlanmayan diğer tüm parametreler, eklenti Ayarlarındaki değer kullanılarak ayarlanacaktır.
Bu sınıfı eklentinin içindeki src/Gato.php dosyası altında bulabilirsiniz.
namespace GatoStandalone\GatoAITranslationsForPolylang;
class Gato
{
/**
* Alias of `translateCustomPosts`
*
* @param int|int[] $ids Array of custom post IDs to translate
* @param string|null $statusToUpdate The status the custom posts must have to be updated
* @param string|null $statusWhenTranslated The status the custom posts will have after translation. Possible values: "draft", "pending", "publish", "private", "current" (i.e. don't modify the status), "same-as-origin" (i.e. copy the status from the origin post)
* @param array<string,string>|null $languageProviders Array of: Key => language code, Value: Provider name, "none" to disable for that language, or "default" to use the default provider
* @return array<string|int>|false Array of custom post IDs that were processed for translation, or `false` if none of the provided IDs was valid
* @throws PolylangNotActiveException
* @throws LicenseNotActiveException
* @throws PluginNotInitializedException
*/
public static function translate(
int|array $ids,
?string $statusToUpdate = null,
?string $statusWhenTranslated = null,
?bool $copyDate = null,
?bool $translateSlugs = null,
?array $languageProviders = null,
?string $defaultTranslationProvider = null,
): array|false;
/**
* Translate custom posts
*
* @param int|int[] $ids Array of custom post IDs to translate
* @param string|null $statusToUpdate The status the custom posts must have to be updated
* @param string|null $statusWhenTranslated The status the custom posts will have after translation. Possible values: "draft", "pending", "publish", "private", "current" (i.e. don't modify the status), "same-as-origin" (i.e. copy the status from the origin post)
* @param array<string,string>|null $languageProviders Array of: Key => language code, Value: Provider name, "none" to disable for that language, or "default" to use the default provider
* @return array<string|int>|false Array of custom post IDs that were processed for translation, or `false` if none of the provided IDs was valid
* @throws PolylangNotActiveException
* @throws LicenseNotActiveException
* @throws PluginNotInitializedException
*/
public static function translateCustomPosts(
int|array $ids,
?string $statusToUpdate = null,
?string $statusWhenTranslated = null,
?bool $copyDate = null,
?bool $translateSlugs = null,
?array $languageProviders = null,
?string $defaultTranslationProvider = null,
): array|false;
/**
* Translate taxonomy terms (categories and tags)
*
* @param int|int[] $ids Array of taxonomy term IDs to translate
* @param array<string,string>|null $languageProviders Array of: Key => language code, Value: Provider name, "none" to disable for that language, or "default" to use the default provider
* @return array<string|int>|false Array of taxonomy term IDs that were processed for translation, or `false` if none of the provided IDs was valid
* @throws PolylangNotActiveException
* @throws LicenseNotActiveException
* @throws PluginNotInitializedException
*/
public static function translateTaxonomyTerms(
int|array $ids,
?bool $translateSlugs = null,
?array $languageProviders = null,
?string $defaultTranslationProvider = null,
): array|false;
/**
* Translate media items
*
* @param int|int[] $ids Array of media item IDs to translate
* @param array<string,string>|null $languageProviders Array of: Key => language code, Value: Provider name, "none" to disable for that language, or "default" to use the default provider
* @return array<string|int>|false Array of media item IDs that were processed for translation, or `false` if none of the provided IDs was valid
* @throws PolylangNotActiveException
* @throws LicenseNotActiveException
* @throws PluginNotInitializedException
*/
public static function translateMedia(
int|array $ids,
?bool $translateSlugs = null,
?array $languageProviders = null,
?string $defaultTranslationProvider = null,
): array|false;
}Yürütme bağlamı
Yöntemlerden herhangi birini yalnızca eklenti başlatıldıktan sonra çalıştırın. Bu, bağlama göre farklı hook'larda gerçekleşir:
| Bağlam | Hook |
|---|---|
| Frontend | 'wp' action hook |
| Admin | 'wp_loaded' action hook |
| REST API | 'rest_jsonp_enabled' filter hook |
Yürütme örnekleri
WordPress hook'larından her birinde çevirilerin yürütülmesi:
use GatoStandalone\GatoAITranslationsForPolylang\Exception\AbstractGatoAITranslationsForPolylangException;
// Frontend
add_action('wp', function() {
try {
Gato::translateCustomPosts(123);
} catch (AbstractGatoAITranslationsForPolylangException $e) {
error_log($e->getMessage());
}
});
// Admin
add_action('wp_loaded', function() {
try {
Gato::translateTaxonomyTerms([456, 789]);
} catch (AbstractGatoAITranslationsForPolylangException $e) {
error_log($e->getMessage());
}
});
// REST API
add_filter('rest_jsonp_enabled', function(mixed $value): mixed {
try {
Gato::translateMedia([101, 102]);
} catch (AbstractGatoAITranslationsForPolylangException $e) {
error_log($e->getMessage());
}
return $value;
});Aşağıdakilerden emin olduğunuzda:
- Polylang etkin
- Eklenti için geçerli bir lisansınız var
- Eklenti başlatıldı (yani yukarıdaki hook'lar çalıştırıldı)
…o zaman çevirileri istisna kontrolü yapmadan yürütebilirsiniz:
Gato::translate(123); // Same as `translateCustomPosts`
Gato::translateCustomPosts(123);
Gato::translateTaxonomyTerms([456, 789]);
Gato::translateMedia([101, 102]);