# fishpig/magento2-wordpress-integration-yoastseo

> Magento 2 WordPress Inegration Addon module to support the WordPress SEO plugin by Yoast.

`composer require fishpig/magento2-wordpress-integration-yoastseo`

Canonical URL: https://packagento.com/fishpig/magento2-wordpress-integration-yoastseo

## At a glance

- **Vendor**: fishpig (https://packagento.com/fishpig.md)
- **Latest version**: 3.3.16 — released 2026-06-19
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/fishpig/magento2-wordpress-integration-yoastseo and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require fishpig/magento2-wordpress-integration-yoastseo:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Magento 2 WordPress Inegration Addon module to support the WordPress SEO plugin by Yoast.

## README

A free Magento 2 module that integrates the Yoast SEO WordPress plugin with WordPress Integration.

## Installation

This module required <a href="https://fishpig.com/magento-2-wordpress-integration" target="_blank">FishPig_WordPress</a> be installed.

### Composer
```
composer require fishpig/magento2-wordpress-integration-yoastseo
bin/magento module:enable FishPig_WordPress_Yoast && bin/magento setup:upgrade --keep-generated
```

### Manual
```
mkdir -p app/code/FishPig && cd app/code/FishPig && \
curl -sS https://codeload.github.com/bentideswell/magento2-wordpress-integration-yoastseo/zip/master -o master.zip && \
unzip -q master.zip && rm -rf master.zip && mv magento2-wordpress-integration-yoastseo-master WordPress_Yoast && \
cd - && bin/magento module:enable FishPig_WordPress_Yoast && bin/magento setup:upgrade --keep-generated
```

## WordPress Integration Add-ons

The following add-ons are currently available and more are on the way.

- <a href="https://fishpig.com/magento-2-wordpress-integration/multisite" target="_blank">Multisite</a>
- <a href="https://fishpig.com/magento-2-wordpress-integration/root" target="_blank">Root</a>
- <a href="https://fishpig.com/magento-2-wordpress-integration/post-types-taxonomies" target="_blank">Post Types and Taxonomies</a>
- <a href="https://fishpig.com/magento-2-wordpress-integration/shortcodes" target="_blank">Shortcodes</a>
- <a href="https://fishpig.com/magento-2-wordpress-integration/advanced-custom-fields" target="_blank">Advanced Custom Fields (ACF)</a>
- <a href="https://fishpig.com/magento-2-wordpress-integration/related-products" target="_blank">Related Products</a>
- <a href="https://fishpig.com/magento-2-wordpress-integration/integrated-search" target="_blank">Integrated Search</a>
- <a href="https://fishpig.com/magento-2-wordpress-integration/wpml" target="_blank">WPML</a>

For an up to date list, check the <a href="https://fishpig.com/magento-2-wordpress-integration/add-ons" target="_blank">Magento 2 WordPress Integration Add-ons</a> page.

## Changelog

Change log for FishPig_WordPress_Yoast.

### [3.3.16] - 2026-06-19
#### [Fixed]
- Fixed missing date helper when rewriting SEO strings.

## [3.3.15] - 2025-09-12
#### [Changed]
- Remove unreplaced template variables

### [3.3.14] - 2025-07-26
#### [Changed]
- Changed escaping of OG tag names to allow unescaped colons.

### [3.3.12] - 2025-07-18
#### [Fixed]
- Added PHP 8.4 compatibility

### [3.3.11] - 2024-02-26
#### [Fixed]
- Fixed issue with stripcategorybase plugin option. Even if this is set in Admin,
  it can be overwritten in config as key is set in multiple options.

### [3.3.10] - 2024-03-21
#### [Changed]
- Changed links in README.md to use fishpig.com.

### [3.3.9] - 2024-03-20
#### [Added]
- Added pt_plural and pt_single variables to post view templates.

## [3.3.8] - 2024-01-27
#### [Changed]
- Moved permalink plugin to global scope to ensure it runs during XML sitemap generation.

### [3.3.7] - 2024-01-08
#### [Fixed]
- Removed trailing comma in getTypeOption method declaration.

### [3.3.6] - 2023-12-19
#### [Fixed]
- Fixed config retrieval for post types that contain a hyphen. Yoast changes this
  to an underscore.

### [3.3.5] - 2023-07-03
#### [Added]
- Added WP theme file to stop CSS file being included in the XML sitemap index.
  This fixes CORS issues when using external integration and a separate WP
  domain.

### [3.3.4] - 2023-06-08
#### [Changed]
- Changed AssetProvider to use canProvideAssets method.

### [3.3.3] - 2023-06-08
#### [Fixed]
- Fixed issue introduced in 3.3.1 with dynamic routes.

### [3.3.2] - 2023-05-09
#### [Fixed]
- Fixed bug where term meta description template was not used.

### [3.3.1] - 2023-04-17
#### [Changed]
- Added plugin to change dynamic routing of category URLs when using /category/
  prefix even though Yoast config forbids this. This now results in a 404.

### [3.3.0] - 2023-03-22
#### [Added]
- Added PHP 8.2 support.

### [3.2.1] - 2023-01-03
#### [Changed]
- Changed string rewriting to include support for %%primary_category%%

### [3.2.0] - 2022-08-26
#### [Added]
- Added support for Premium URL redirects.

### [3.1.1] - 2022-08-05
#### [Fixed]
- \FishPig\WordPress\Model\Post::isPublic now returns false if post is set to
  noindex.

### [3.1.0] - 2022-07-19
#### [Added]
- Added a Factory class to prevent PSR-0 errors when optimizing the composer autoloader.

### [3.0.9] - 2022-05-04
- Fixed strict type error for str_replace

### [3.0.8] - 2022-03-16
#### [Fixed]
- Open Graph now uses meta description if specific description not set.

### [3.0.7] - 2022-03-14
#### [Fixed]
- Fixed missing YoastHelper class in StringRewriter.

### [3.0.5] - 2022-02-08
#### [Changed]
- Removed trailing commas to fix some PHP 7.2 compat issues. This is fine in PHP 7.3 and above.

### [3.0.4] - 2022-01-06
#### Fixed
- Various strict type errors
- Incorrect variable name ($object, should have been $postType)

### [3.0.2] - 2021-12-22
#### [Changed]
- Code formatting clean up

### [3.0.1] - 2021-12-16
#### Fixed
- Updated some references to legacy classes to the new versions.

### [3.0.0] - 2021-12-15
A new major version to support the changes in fishpig/magento2-wordpress-integration (FishPig_WordPress)

----- Legacy Change Log Below -------

21/05/2021 - 2.0.11.6
- Fixed issue when using custom post titles.

18/12/2020 - 2.0.11.5
- Fixed issue when rewriteString encounters an array from ACF.

30/06/2020 - 2.0.11.4
- Changed Data helper to Proxy in Breadcrumbs plugin.

10/01/2020 - 2.0.0.25
- Code formatting cleanup

16/12/2019 - 2.0.0.24
- Optimised meta data retrieval when using Shortcodes & Widgets

23/11/2019 - 2.0.0.23
- Fixed issue with og:url when using static page as posts page

14/11/2019 - 2.0.0.22
- Fixed several issues with author meta data

28/10/2019 - 2.0.0.21
- Fixed og:image tag so original image is used rather than the 150x150 thumbnail

25/10/2019 - 2.0.0.19
- Fixed issue when using %category% in permalink structure

_(Changelog truncated for .md surface. Full history on https://packagento.com/fishpig/magento2-wordpress-integration-yoastseo.)_

## Recent Versions

| Version | Released |
|---|---|
| 3.3.16 | 2026-06-19 |
| 3.3.15 | 2025-09-12 |
| 3.3.14 | 2025-07-26 |
| 3.3.12 | 2025-07-18 |
| 3.3.11 | 2024-03-26 |
| 3.3.10 | 2024-03-21 |
| 3.3.9 | 2024-03-20 |
| 3.3.8 | 2024-01-27 |
| 3.3.7 | 2024-01-08 |
| 3.3.6 | 2023-12-19 |

Showing 10 of 80 versions. Full release history on https://packagento.com/fishpig/magento2-wordpress-integration-yoastseo.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| fishpig/magento2-wordpress-integration | ^3.29.0 |

## Quality

Latest release (3.3.16) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 61 | 61 warnings (ruleset: Magento2) |
| PHPMD | Warning | 42 | 42 rule violations (IfStatementAssignment:24, UnusedFormalParameter:9, UnusedLocalVariable:4, NPathComplexity:2, UnusedPrivateField:1) |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 2 | valid; 2 advisory notes (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 554 | 554 | – | – |
| 2.4.8 | – | 556 | 556 | – |
| 2.4.9 | – | – | 554 | 554 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["fishpig/magento2-wordpress-integration-yoastseo"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

fishpig is a Magento 2 vendor on Packagento. See https://packagento.com/fishpig.md for their full catalogue.

