| 1 |
=== Bogo === |
| 2 |
Contributors: takayukister |
| 3 |
Tags: multilingual, localization, language, locale, admin |
| 4 |
Requires at least: 3.5 |
| 5 |
Tested up to: 3.6.1 |
| 6 |
Donate link: http://www.pledgie.com/campaigns/17860 |
| 7 |
Stable tag: 2.1 |
| 8 |
License: GPLv2 or later |
| 9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 |
|
| 11 |
A straight-forward multilingual plugin. No more double-digit custom DB tables or hidden HTML comments that could cause you headaches later on. |
| 12 |
|
| 13 |
== Description == |
| 14 |
|
| 15 |
http://ideasilo.wordpress.com/bogo/ |
| 16 |
|
| 17 |
Bogo is a straight-forward multilingual plugin for WordPress. |
| 18 |
|
| 19 |
The core of WordPress itself has [the built-in localization capability](http://codex.wordpress.org/WordPress_in_Your_Language) so you can use the dashboard and theme in one language other than English. Bogo expands this capability to let you easily build a multilingual blog on a single WordPress install. |
| 20 |
|
| 21 |
Here are some technical details for those interested. Bogo plugin assigns [one language per post](http://codex.wordpress.org/Multilingual_WordPress#Different_types_of_multilingual_plugins). It plays nice with WordPress – Bogo does not create any additional custom table on your database, unlike some other plugins in this category. This design makes Bogo a solid, reliable and conflict-free multilingual plugin. |
| 22 |
|
| 23 |
= Getting Started with Bogo = |
| 24 |
|
| 25 |
1. Install language files |
| 26 |
|
| 27 |
First, make sure you have installed language files (*.mo) for all languages used in your site. If you have a localized version of WordPress installed, you should already have these files for that language. |
| 28 |
|
| 29 |
If you don't have language files yet, you can download them from [the WordPress Localization Repository](http://codex.wordpress.org/Translating_WordPress#WordPress_Localization_Repository). |
| 30 |
|
| 31 |
2. Select your language for admin screen (dashboard) |
| 32 |
|
| 33 |
Bogo allows each user to select a language for his/her own WordPress admin screen. Logged-in users can switch languages from the drop-down menu on the Admin Bar. |
| 34 |
|
| 35 |
If the Admin Bar is hidden, you can also switch language on your Profile page. |
| 36 |
|
| 37 |
3. Translate posts and pages |
| 38 |
|
| 39 |
You can translate any posts and pages into your language you have set at the step 2 above with the Language post box. |
| 40 |
|
| 41 |
WordPress saves the contents of each post or page as usual, but Bogo adds '_locale' post_meta data. The '_locale' holds the language code of the post. |
| 42 |
|
| 43 |
4. Add a language switcher to your site |
| 44 |
|
| 45 |
You will want to place a language switcher on your site that allows visitors to switch languages they see on the site. The easiest method is using the Language Switcher widget included in Bogo. |
| 46 |
|
| 47 |
Bogo also provides a shortcode "[bogo]" to allow you to place a language switcher inside a post or page content by simply inserting [bogo]. To embed a language switcher directly into your theme's template file, use this shortcode as follows: |
| 48 |
|
| 49 |
`<?php echo do_shortcode( '[bogo]' ); ?>` |
| 50 |
|
| 51 |
== Installation == |
| 52 |
|
| 53 |
1. Upload the entire `bogo` folder to the `/wp-content/plugins/` directory. |
| 54 |
1. Activate the plugin through the 'Plugins' menu in WordPress. |
| 55 |
|
| 56 |
== Screenshots == |
| 57 |
|
| 58 |
1. You can switch your admin language in the Admin Bar. |
| 59 |
1. The Language Post Box manages language and translations of the Post/Page. |
| 60 |
|
| 61 |
== Changelog == |
| 62 |
|
| 63 |
= 2.1 = |
| 64 |
|
| 65 |
* Correctly handle Custom Post Type's localized permalinks. |
| 66 |
* Correctly handle sticky posts and front page's translation. |
| 67 |
* Add locale class to post_class. |
| 68 |
* The required WordPress version has been changed and now requires WordPress 3.5 or higher. |
