PHPackages                             moderntribe/weglot-companion - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. moderntribe/weglot-companion

AbandonedArchivedWordpress-plugin[Localization & i18n](/categories/localization)

moderntribe/weglot-companion
============================

Weglot Companion WordPress Plugin

1.3.1(3y ago)02PHPPHP >=7.4

Since May 9Pushed 3y ago11 watchersCompare

[ Source](https://github.com/moderntribe/weglot-companion)[ Packagist](https://packagist.org/packages/moderntribe/weglot-companion)[ Docs](https://github.com/moderntribe/weglot-companion)[ RSS](/packages/moderntribe-weglot-companion/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (10)Dependencies (20)Versions (14)Used By (0)

Weglot Companion
================

[](#weglot-companion)

Provides additional functionality for the [Weglot Translate Plugin](https://wordpress.org/plugins/weglot/).

---

This plugin makes available the following features:

1. Translation caching using object caching.
2. Better translate filters/interfaces for developer use to translate content manually that Weglot is unable to translate.

Manually translate content that Weglot misses, like HTML returned from an Ajax request.

The Weglot plugin must be installed and activated for this to work, otherwise it will just silently return the original content.

#### Translate an HTML string

[](#translate-an-html-string)

```
$translated = apply_filters( \Tribe\Weglot\Translate\Translate_Subscriber::FILTER, 'Some kind of HTML content' );
```

#### Translate an array of HTML strings

[](#translate-an-array-of-html-strings)

```
$translated = apply_filters( \Tribe\Weglot\Translate\Translate_Subscriber::FILTER, [
    'some content',
    'some more content'
    // etc...
] );
```

---

### Requirements

[](#requirements)

- php7.4+
- docker
- docker-compose v2+
- nvm or fnm
- node 16+
- yarn 1.22+
- npm 8.3+

### Quick Start First Run

[](#quick-start-first-run)

1. Install [SquareOne Docker (so)](https://github.com/moderntribe/square1-global-docker#squareone-docker)
2. Run: `nvm use`
3. Run: `yarn install`
4. Run: `yarn mix`
5. Run: `so bootstrap`
6. Activate your plugin(s) in the WordPress dashboard and start developing!

### Pull Requests / Building

[](#pull-requests--building)

Ensure you run `nvm use` and `yarn prod` and commit the `resources/dist` folder before submitting a PR, so the plugin includes the latest front-end production build.

### Front end

[](#front-end)

Front end building is powered by [Laravel Mix](https://laravel-mix.com/).

#### Installation

[](#installation)

```
nvm use; yarn install
```

#### Usage

[](#usage)

Run once: `nvm use` and then...

Build for development:

```
yarn dev
```

Watch for file changes:

```
yarn watch
```

Poll for file changes:

```
yarn watch-poll
```

Watch with hot module replacement:

```
yarn hot
```

Build for production:

```
yarn prod
```

See more options: `yarn mix --help`

### Installing this plugin

[](#installing-this-plugin)

#### Composer

[](#composer)

If you're using our [SquareOne Framework](https://github.com/moderntribe/square-one) with [Tribe Libs](https://github.com/moderntribe/tribe-libs) v3.4+ you can likely just create a release and composer require the plugin. However, if this results in composer conflicts that can't be resolved, use the private composer method below.

```
composer require moderntribe/weglot-companion
```

#### Private Composer Installer

[](#private-composer-installer)

Every published [release](https://github.com/moderntribe/weglot-companion/releases) automatically creates a `weglot-companion.zip` which is a fully built and vendor scoped WordPress plugin, about a minute after the release is published. To manually install, visit a release and download and extract the zip in your WordPress plugins folder.

However, the best way to include the release zip is by using the fantastic [ffraenz/private-composer-installer](https://github.com/ffraenz/private-composer-installer) plugin.

Add a custom repository to your project's `repository` key in `composer.json`:

```
  "repositories": [
    {
      "type": "package",
      "package": {
        "name": "moderntribe/weglot-companion",
        "version": "1.0.0",
        "type": "wordpress-plugin",
        "dist": {
          "type": "zip",
          "url": "https://github.com/moderntribe/weglot-companion/releases/download/{%VERSION}/weglot-companion.zip"
        },
        "require": {
          "ffraenz/private-composer-installer": "^5.0"
        }
      }
    },
 ],
```

> NOTE: Simply update the version above and run `composer update` to upgrade the plugin in the future.

Then, add the plugin definition to the require section:

```
  "require": {
    "moderntribe/weglot-companion": "*",
  }
```

Tell composer where to put your WordPress plugins/themes via the `extra` section.

> NOTE: Adjust the paths based on your project.

```
  "extra": {
    "wordpress-install-dir": "wp",
    "installer-paths": {
      "wp-content/mu-plugins/{$name}": [
        "type:wordpress-muplugin"
      ],
      "wp-content/plugins/{$name}": [
        "type:wordpress-plugin"
      ],
      "wp-content/themes/{$name}": [
        "type:wordpress-theme"
      ]
    }
  },
```

You may have to allow this plugin in your config as well:

```
    "allow-plugins": {
      "composer/installers": true,
      "ffraenz/private-composer-installer": true,
    }
```

Finally, install the plugin:

```
composer update
```

### Tests

[](#tests)

Automated testing is powered by [wp-browser](https://wpbrowser.wptestkit.dev/) and [Codeception](http://codeception.com/).

`so test` is a proxy command for the [codeception cli](https://codeception.com/docs/reference/Commands).

Run all test suites:

```
so project:test
```

Or, run an individual test suite: `unit, integration, functional, webdriver`, e.g.

```
so test run integration
```

Or, run with debugging enabled:

```
so -- test run integration --debug
```

### Credits

[](#credits)

- Based on [Spatie Skeleton](https://github.com/spatie/package-skeleton-php)

### License

[](#license)

GNU General Public License GPLv2 (or later). Please see [License File](LICENSE.md) for more information.

### Modern Tribe

[](#modern-tribe)

[![https://tri.be/contact/](https://camo.githubusercontent.com/1cc6134398300c1d34d415968e0e105345f0a946e07d8605a3945fa3cd1003f0/68747470733a2f2f6d6f6465726e74726962652d636f6d6d6f6e2e73332e75732d776573742d322e616d617a6f6e6177732e636f6d2f6d61726b6574696e672f4d6f6465726e54726962652d42616e6e65722e706e67)](https://camo.githubusercontent.com/1cc6134398300c1d34d415968e0e105345f0a946e07d8605a3945fa3cd1003f0/68747470733a2f2f6d6f6465726e74726962652d636f6d6d6f6e2e73332e75732d776573742d322e616d617a6f6e6177732e636f6d2f6d61726b6574696e672f4d6f6465726e54726962652d42616e6e65722e706e67)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~9 days

Recently: every ~26 days

Total

13

Last Release

1350d ago

PHP version history (2 changes)1.0.0PHP ^7.4||^8.0

1.3.0PHP >=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/1a11f5bee6606989680c8f81b921f8a8e2e75bfd5190cb001812ed615d032a5e?d=identicon)[tribejustin](/maintainers/tribejustin)

---

Top Contributors

[![defunctl](https://avatars.githubusercontent.com/u/1066195?v=4)](https://github.com/defunctl "defunctl (23 commits)")[![whoami-pwd](https://avatars.githubusercontent.com/u/33621842?v=4)](https://github.com/whoami-pwd "whoami-pwd (1 commits)")

---

Tags

modern tribeweglot-companion

### Embed Badge

![Health badge](/badges/moderntribe-weglot-companion/health.svg)

```
[![Health](https://phpackages.com/badges/moderntribe-weglot-companion/health.svg)](https://phpackages.com/packages/moderntribe-weglot-companion)
```

###  Alternatives

[symfony/translation

Provides tools to internationalize your application

6.6k836.5M2.1k](/packages/symfony-translation)[nesbot/carbon

An API extension for DateTime that supports 281 different languages.

169661.4M4.8k](/packages/nesbot-carbon)[joedixon/laravel-translation

A tool for managing all of your Laravel translations

717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation

The Illuminate Translation package.

6936.4M495](/packages/illuminate-translation)[larswiegers/laravel-translations-checker

Make sure your laravel translations are checked and are included in all languages.

256423.2k2](/packages/larswiegers-laravel-translations-checker)[terminal42/contao-changelanguage

ChangeLanguage extension for Contao Open Source CMS

47240.6k16](/packages/terminal42-contao-changelanguage)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)