https://github.com/rburgst/wp-graphql-wpml

a wordpress plugin that improves wpgraphql usage together with wpml
https://github.com/rburgst/wp-graphql-wpml

wordpress wordpress-plugin wpgraphql-plugin wpml

Last synced: 2 months ago
JSON representation

a wordpress plugin that improves wpgraphql usage together with wpml

• Host: GitHub
• URL: https://github.com/rburgst/wp-graphql-wpml
• Owner: rburgst
• License: gpl-3.0
• Created: 2020-09-07T12:31:57.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-03-22T11:35:48.000Z (almost 2 years ago)
• Last Synced: 2024-11-01T20:36:23.596Z (2 months ago)
• Topics: wordpress, wordpress-plugin, wpgraphql-plugin, wpml
• Language: PHP
• Homepage:
• Size: 170 KB
• Stars: 49
• Watchers: 6
• Forks: 19
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-wordpress-gatsby - WPGraphQL WPML - This FREE plugin from @rburgst extends the WPGraphQL schema with language data from the WPML plugin. In addition it turns off WPML default filters in order to be able to iterate over all posts regardless of language. (Plugins / WordPress)

README

        
# WPGraphQL WPML Extension

* **Contributors:** rburgst

* **Stable tag:** 1.1.0

* **Tested up to:** 5.6.1

* **Requires at least:** 4.9

* **Requires PHP:** 7.0

* **Requires WPGraphQL:** 0.8.0+

* **Requires WPML:** 4.4.5+

* **Tags:** GraphQL, WPML, WPGraphQL

* **License:** GPL-3

* **License URI:** https://www.gnu.org/licenses/gpl-3.0.html

## Description

Adds WPML functionality to wpgraphql so that translations can be queried

and WPML default filters which disable the listing of all content

are disabled.

Note that the primary use case for this plugin is to be used together with Gatsby

where you can perform all filtering of your content within the Gatsby GraphQL schema.

Since Gatsby pulls the whole content out of the wordpress database, this plugin

will ensure that all translations of the translated content is being returned

(instead of only content in the default language).

If you dont intend to use this plugin together with Gatsby be aware that you 

will typically have to be creative with filtering, see #8, #9.

Thanks to https://github.com/shawnhooper/wpml-rest-api

and https://github.com/valu-digital/wp-graphql-polylang

## Caveats

In case you are getting issues querying data (i.e. http 302, or errors), please

first try to see whether you can successfully query data without this plugin.

If it does not work without this plugin, then enabling this plugin wont

magically heal your broken ACF config (see also #5).

This plugin will only help in getting "more" content from your

wordpress installation (which was previously disabled by WPML interfering with queries).

## Limitations

Due to the main use case of using this plugin together with gatsby some often required 

filtering options are not yet available, such as

* filtering menus by locale/language (see [#3](https://github.com/rburgst/wp-graphql-wpml/issues/3))