Yard | Digital Agency

Mike van den Hoek

<p>This plugin registers secure API endpoints that allow you to request translations directly from DeepL without exposing your Deepl API-key. These endpoints are only accessible when a valid nonce is provided. When providing translations to website visitors, you can configure which languages are supported for translation.</p>
<h3>Caching Mechanism</h3>
<p>Each object that is translated will store its cached translation in the <code>wp_postmeta</code> table within the database. This caching mechanism ensures that translations are efficiently reused, reducing unnecessary API requests to DeepL and saving costs.</p>
<ul>
<li>Serving Cached Translations: If a cached translation is newer than the <code>post_modified</code> date of the object, the cached version is served.</li>
<li>Fetching New Translations: When the <code>post_modified</code> date of the object is more recent than the cached translation, a new translation is fetched from DeepL. Once retrieved, this translation is immediately cached for future use.</li>
</ul>
<p>This approach minimizes the number of API calls to DeepL, ensuring translations are kept up to date only when necessary.</p>
<h3>External Services</h3>
<p>This plugin connects to the DeepL API to provide translations for content.</p>
<ul>
<li><strong>Service:</strong> DeepL API (https://www.deepl.com)</li>
<li><strong>Purpose:</strong> To translate text from one language to another based on the provided target language.</li>
<li><strong>Data Sent:</strong> Text content for translation, the target language code, and the DeepL API key (handled securely and never exposed to users).</li>
<li><strong>Conditions:</strong> Data is sent when a request for translation is initiated.</li>
<li><strong>Privacy Policy:</strong> <a href="https://www.deepl.com/privacy" rel="nofollow ugc">DeepL Privacy Policy</a></li>
<li><strong>Terms of Service:</strong> <a href="https://www.deepl.com/pro-license" rel="nofollow ugc">DeepL Terms of Service</a></li>
</ul>
<h3>Usage</h3>
<h3>Security</h3>
<p>The API endpoints registered by this plugin are secured using a WordPress nonce. The nonce is passed to the front-end using the <code>wp_localize_script</code> function and is stored in a global JavaScript object <code>ydpl</code> which contains the following properties:</p>
<ul>
<li><code>ydpl_translate_post_id</code>: The ID of the post to be translated.</li>
<li><code>ydpl_rest_translate_url</code>: The URL of the API endpoint for translation requests.</li>
<li><code>ydpl_supported_languages</code>: The list of languages supported for translation.</li>
<li><code>ydpl_api_request_nonce</code>: The nonce used for API validation.</li>
</ul>
<p>When making requests to the API, ensure that the nonce is included in the request headers. The header should be named <code>nonce</code>, and it should contain the value of <code>ydpl_api_request_nonce</code>.</p>
<h3>Example</h3>
<h3>Request</h3>
<pre><code>var xhr = new XMLHttpRequest();
xhr.open('POST', ydpl.ydpl_rest_translate_url, true);

// Set request headers
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.setRequestHeader('nonce', ydpl.ydpl_api_request_nonce);

// Handle response
xhr.onreadystatechange = function () {
    if (xhr.readyState === 4 && xhr.status === 200) {
        console.log('Translation:', JSON.parse(xhr.responseText));
    } else if (xhr.readyState === 4) {
        console.error('Error:', xhr.statusText);
    }
};

// Prepare and send the request body
var data = JSON.stringify({
    text: ["Look another test"],
    target_lang: "DE"
});

xhr.send(data);
</code></pre>
<h3>Response</h3>
<pre><code>[
    {
        "text": "Look another test!",
        "translation": "Sehen Sie sich einen weiteren Test an!"
    }
]
</code></pre>


Yard DeepL

This plugin registers secure API endpoints that allow you to request translations directly from DeepL without exposing your DeepL API-key.

Alexandre Gaboriau

<p>Automatic Translate Posts & Pages with <a href="https://www.deepl.com/" rel="nofollow ugc">Deepl</a>.</p>
<p>You need a Deepl API key to apply translations.</p>
<p>You can :</p>
<ul>
<li>Set your Deepl API key</li>
<li>Choose betweeen 9 languages : English, German, French, Spanish, Portuguese, Italian, Dutch, Polish, Russian</li>
<li>Translate chosen posts</li>
<li>Translate chosen pages</li>
<li>Translate chosen custom post type</li>
<li>Translate all posts in a category</li>
</ul>
<p><a href="https://www.deepl.com/privacy.html" rel="nofollow ugc">Privacy Terms of Deepl</a></p>
<h3>Translations</h3>
<ul>
<li>English</li>
<li>French</li>
</ul>
<h3>Support the plugin</h3>
<p>If you’ve found the plugin useful, please consider <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=contact%40magic-post-thumbnail.com&item_name=Donation+for+Magic+Post+Thumbnail&currency_code=EUR&source=url" rel="nofollow ugc">making a donation</a>. You can also visit my <a href="http://amzn.eu/cDuEDyU" rel="nofollow ugc">Amazon Wishlist</a>. Thank you for your support !</p>


Magic Post Translate

Automatic Translate Posts & Pages with Deepl

Yard DeepL vs Magic Post Translate