WordPress extension to polylang plugin to allow posts to be displayed in multiple languages
Shell PHP
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
tests
.gitignore
.travis.yml
LICENSE
deploy.sh
multilingual-polylang.php
phpunit.xml
readme.txt

readme.txt

=== Multilingual Polylang ===
Contributors: Aptivate
Tags: polylang, multilingual, bilingual, translate, translation, language, multilanguage, international, localization
Requires at least: 4.0
Tested up to: 4.7.5
Stable tag: 1.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html


== Description ==

This plugin, which requires [polylang](https://wordpress.org/plugins/polylang/)
provides the means to include posts that have no translation in the current
language on pages of posts.

= Usage =

Multilingual Polylang provides two public functions:

The function `MultilingualPolylang::get_query()` returns a `WP_Query` object with posts from
all languages but where there is a translated post, only the post in the current
language will be included

The function `MultilingualPolylang::get_permalink()` can be used as a drop-in replacement to
`get_permalink()`. This will replace the language in a post URL so that a post
can be viewed in a language different to that of the rest of the interface.

[Follow this project on GitHub](https://github.com/aptivate/multilingual-polylang)


== Installation ==

1. Upload the plugin to the `/wp-content/plugins/` directory.
2. Activate it through the **Plugins** menu in WordPress.

== Changelog ==

= 1.0.1 =
* Documentation changes only

= 1.0.0 =
* First version

== Upgrade Notice ==

= 1.0.0 =
* First version


== Development ==

This plugin uses [wp-cli](http://wp-cli.org/) and [PHPUnit](https://phpunit.de/) for testing.

= Download the source code from GitHub =

`$ git clone git@github.com:aptivate/multilingual-polylang.git`

= Install wp-cli =

If not already present, install [wp-cli](http://wp-cli.org/#install)

= Install PHPUnit =

If not already present, install [PHPUnit](https://phpunit.de/)

= Install the test WordPress environment =

`$ cd multilingual-polylang`
`$ bash bin/install-wp-tests.sh test_db_name db_user 'db_password' db_host version`

where:

*  `test_db_name` is the name of your **temporary** test WordPress database
*  `db_user` is the database user name
*  `db_password` is the password
*  `db_host` is the database host (eg `localhost`)
*  `version` is the version of WordPress (eg `4.7.5` or `latest`)

= Run the tests =
From the plugin directory:

`$ phpunit`