=== SELISE Blocks Localization Language Translator ===

Contributors: selisegroup
Tags: Localization, WordPress translation, Translate plugin, Multilingual plugin, AI translation
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.5
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The AI Language Translator plugin that instantly translates any theme or plugin for managing multilingual interfaces.

== Description ==

Find, edit, translate, and publish languages for your WordPress site or application, directly in your WordPress dashboard.

SELISE Blocks Localization Language Translator is a multilingual AI translator designed to help WordPress sites manage translations at scale. The plugin enables you to translate plugins & themes in different languages, update or delete translations, and apply AI-powered suggestions across themes and plugins, without relying on manual translation workflows.

Built for flexibility, it works independently of specific themes and integrates seamlessly with existing WordPress language switcher plugins.

== Main Features ==

- Easily add new languages to translate the site without hassle. Remove unused languages to keep the system clean and organized. Set a default language that will be shown to visitors when no specific language is selected. Quickly switch the default language when needed.

- Search translation strings by theme or plugin, instead of browsing large language files. This saves significant time and removes guesswork, especially for large websites with multiple plugins and themes installed.

- Automatically suggests translations for selected strings. This helps users translate faster, especially when working with unfamiliar languages. Reduces manual typing and translation errors.

- Add new translation strings when custom text is introduced. Edit existing translations to improve wording or fix mistakes. Delete unused or incorrect translations to keep language files clean.

- SELISE Blocks Localization Language Translator is designed for developers, agencies, and site owners who want fast, reliable, and editable translations without complex setup.

== Installation ==

Follow these steps to install and activate the plugin on your WordPress website:

- Log in to your WordPress Admin Dashboard.
- From the left-hand menu, go to Plugins → Add New.
- In the search box, type “SELISE Blocks Localization Language Translator”.
- Once the plugin appears in the search results, click Install Now.
- After installation is complete, click Activate.
✅ The plugin is now successfully installed and activated.

== How to setup ==

You can find the setup guide [here](https://selisegroup.com/wp-content/uploads/plugin-documnets/selise-blocks-localization-language-translator-setup-guide.pdf).

= Creating a SeliseBlocks Cloud Account =

- The plugin requires API credentials from SeliseBlocks Cloud to work properly.
- Open your browser and go to [https://cloud.seliseblocks.com](https://cloud.seliseblocks.com)
- Create a new account or log in if you already have one.
- From the SeliseBlocks Dashboard, click Add Project.
- Open the newly created project.
- Click Add Environment.
- Now select production and select save.
- Once the environment is created, you’ll need to collect several keys and values for the plugin settings.

= Project Origin: =

- Go to the Environment Dashboard.
- Find Project Origin.
- Click the Configure button.
- Copy the Application Domain URL.

= Project key: =

- Client ID & Client Secret
- From the SeliseBlocks dashboard, navigate to:
- Identity → Authentication
- Enable the Client Credential checkbox.
- Click Save.

After saving, go to the Client Credential tab.
Copy the following values:

- Client ID
- Client Secret

⚠️ Keep these credentials secure and do not share them publicly.

= Setup Permissions =

- Go to the Blocks dashboard and go to Access Manager from the sidebar.
- Navigate to Permission Tab.
- Then Click on Add Permission.
- Now Add all 9 permission as mentioned in permissions section. Note that Name and Resource fields need to be populated as per the permission section.
- Type field: "Endpoint"
- Group field: "Selection"
- Severity: "Medium"
  Now click on Save. And add all 9 permissions one by one.

9. Now Navigate to Roles Tab, click on the number of permissions in the user row. Click on Edit Permissions, scroll down and mark check on all Localization permissions and save changes.

= List of Permissions =

Name: localization::config::savewebhook
Resourse: blocks-localization-api::config::savewebhook

Name: localization::key::delete
Resourse: blocks-localization-api::key::delete

Name: localization::key::generateuilmfile
Resourse: blocks-localization-api::key::generateuilmfile

Name: localization::key::savekeys
Resourse: blocks-localization-api::key::savekeys

Name: localization::key::translateall
Resourse: blocks-localization-api::key::translateall

Name: localization::language::delete
Resourse: blocks-localization-api::language::delete

Name: localization::language::save
Resourse: blocks-localization-api::language::save

Name: localization::language::setdefault
Resourse: blocks-localization-api::language::setdefault

Name: localization::module::save
Resourse: blocks-localization-api::module::save

= Plugin Configuration in WordPress =

- Go back to your WordPress Admin Dashboard.
- Open the SELISE Blocks Localization Language Translator plugin settings.

Paste the following details:
- Project Origin
- Project Key
- Client ID
- Client Secret

Save the settings.

🎉 Your plugin is now fully configured and ready to use.

== How to use ==

How to Use the SELISE Blocks Localization Language Translator Plugin

Before translating any content, you must add the languages you want to use.

- Go to your WordPress Admin Dashboard.
- Navigate to Blocks Localization → Languages.
- Select the language you want to add.
- Click Add Language.
- Select or enter your desired languages.
- Save the changes.

✅ Your translation languages are now ready.

= Navigate to Theme Translation =

- Go to Blocks Localization → Themes.
- This section allows you to manage translations for installed themes.

= Create or Detect a Translation Template =

Click the Add button.

Blocks Localization will:

- Automatically create a .pot template file if the theme does not already have one, or
- Detect and use the existing .pot file from the theme if it is available.

= Edit Theme Translation Strings =

After the template is created or detected, click Edit Template.

You can now:

- View all available theme strings
- Add translations
- Modify existing translations
- Save your changes once you are done.

== External services ==

This plugin connects to the SELISE Blocks API to translate content using AI.

When a translation is requested, the plugin sends the original text and the target language to the API. The API then returns the translated text, which is used to update the content on the website.

For larger translation jobs, such as translating all content at once, the process may take some time to complete. Once the translation is finished, the API sends a notification (webhook) to the website. The website then automatically updates the translation files with the newly translated content.

This service is provided by "SELISE Blocks". SELISE Blocks is an enterprise solution by SELISE Group: [terms of use](https://selisegroup.com/software-development-terms/), [privacy policy](https://selisegroup.com/privacy-policy/).

== Frequently Asked Questions ==

= What can BLOCKS LOCALIZATION translate? =

BLOCKS LOCALIZATION can translate any WordPress theme or plugin that follows WordPress internationalization standards and uses text domains.

= How does the one-click translation work? =

The plugin sends detected strings and text domains to the BLOCKS LOCALIZATION API, which returns translated strings. Users can review and modify translations before saving.

= Can I edit translations manually? =

Yes. BLOCKS LOCALIZATION provides a string-level editor so you can modify any translation individually.

= Where are translation files stored? =

Translations are saved in the appropriate `/languages` directory according to WordPress localization best practices.

= Does BLOCKS LOCALIZATION replace multilingual plugins? =

No. BLOCKS LOCALIZATION focuses on translation and localization management. It can be used alongside multilingual plugins if needed.

= Does BLOCKS LOCALIZATION use any external services? =

Yes. BLOCKS LOCALIZATION uses an external API to provide automatic translation functionality.

When a user initiates the one-click auto translation feature, the plugin sends selected translatable strings and their associated text domains to the BLOCKS LOCALIZATION translation API in order to retrieve translated content.

No personal user data, authentication credentials, or site-specific private information are transmitted. API requests are performed only when explicitly triggered by the user.

More information about data handling can be found at:
[https://www.selisegroup.com/](https://www.selisegroup.com/)

== Screenshots ==

1. Plugin Settings Page
2. Plugin Languages Page
3. Theme Selection Page for Translation
4. Plugin Selection Page for Translation
5. Plugin Translation Page

== Changelog ==

= 1.0.5 =

- Remove unused header parameters from the API request
- Readme file update
- Script debug update
- Plugin banner update

= 1.0.3 =

- WP SVN pipeline update
- Plugin readme.txt & changelog.txt file added

= 1.0.0 =

- Initial public release
- Theme and plugin translation support
- Automatic text-domain detection
- One-click auto translation via BLOCKS LOCALIZATION API
- Manual string editor
- Language file generation

See [changelog.txt](https://plugins.svn.wordpress.org/selise-blocks-localization-language-translator/trunk/changelog.txt) for older changelog
