--- a/web/wp-content/plugins/xili-dictionary/readme.txt Thu Sep 16 15:45:36 2010 +0000
+++ b/web/wp-content/plugins/xili-dictionary/readme.txt Mon Nov 19 18:26:13 2012 +0100
@@ -1,133 +1,173 @@
=== xili-dictionary ===
-Contributors: MS xiligroup
+Contributors: michelwppi, MS dev.xiligroup
Donate link: http://dev.xiligroup.com/
-Tags: theme,post,plugin,posts, page, category, admin,multilingual,taxonomy,dictionary, .mo file, .po file, l10n, i18n, language, international
-Requires at least: 2.8.0
-Tested up to: 2.9.1
-Stable tag: 1.0.3
+Tags: theme,post,plugin,posts, page, category, admin,multilingual,taxonomy,dictionary, .mo file, .po file, l10n, i18n, language, international,wpmu,plural,multisite
+Requires at least: 3.3.2
+Tested up to: 3.4.2
+Stable tag: 2.2.0
+License: GPLv2
-xili-dictionary is a dictionary storable in taxonomy and terms to create and translate .po files or .mo files and more...
+
+xili-dictionary is a dictionary storable in CPT and terms to create and translate .po files or .mo files and more...
== Description ==
-**xili-dictionary is a dictionary storable in taxonomy and terms to create, update and translate .po files or .mo files and more...**
+**xili-dictionary is a dictionary storable in custom post type (CPT) and terms (custom taxonomy) to create, update and translate .po files or .mo files of current theme folder.**
-* xili-dictionary is a plugin (compatible with xili-language) to build a multilingual dictionary saved in the taxonomy tables of WordPress.
-* With this dictionary, collecting terms from categories (title, description), from current theme - international terms with ` _e(), __() or _n() ` functions - , it is possible to create and update .mo file in the current theme folder.
+* xili-dictionary is a plugin (compatible with xili-language) to build a multilingual dictionary saved in the post tables of WordPress as CPT.
+* With this dictionary, collecting terms from taxonomies (title, description), from bloginfos, from wp_locale, from current theme - international terms with ` _e(), __() or _n() or _x(), _ex(), _nx(),... ` functions - , it is possible to create and update .mo file in the current theme folder.
+* By importing .mo files, it is possible to regenerate readable .po files and enrich translation tables.
* xili-dictionary is full compatible with [xili-language](http://wordpress.org/extend/plugins/xili-language/) plugin and [xili-tidy-tags](http://wordpress.org/extend/plugins/xili-tidy-tags/) plugin.
-= 1.0.3 =
-* fixes some directories issues in (rare) xamp servers and in theme's terms import.
-* Create .po with empty translations. Helpful if you send the .po file to a translator that uses app like poedit.
-**1.0.2 beta**
-* Create languages list, if xili-language plugin absent, for international themes - see [post](http://dev.xiligroup.com/?p=312 "xili-dictionary for international themes") - to manage or improve current translations.
-* JS and vars, lot of fixes.
-* Add a term UI now use dynamic input (with javascript included).
-* Now use POMO translations libraries included in WP since 2.8.
-* Add features to set and manage plural terms used by `_n()`
+= roadmap =
+* code source cleaning
+* readme rewritting
+* dictionary for other than theme's .po, .mo files
+
+= 2.2.0 (2012-09-22) =
+
+* fixes issues of 2.1 series (messages, import/export, ctxt, conditions, and more…) - thanks to the adventurers ;-)
-**For previous WP versions (<2.8), please use 0.9.9 release.**
+= 2.1 =
+* requires version 2.6 of xili-language if used in multilingual website context.
+* now uses and saves local .po/mo files (named local-xx_XX.mo) (containing local datas of site not saved in theme's .po/mo files as before).
+* See [xili wiki about XL 2.6 and XD 2.1](http://wiki.xiligroup.org/index.php/Xili-language_v2.6:_what%27s_new_with_xili-dictionary_v2.1).
+* list of untranslated msgs in edit msg screen. See [xili wiki](http://wiki.xiligroup.org/index.php/Xili-dictionary:_what%27s_new_since_version_2.1.2)
+* now uses origin taxonomy to share a dictionary between different themes.
-**0.9.9**
-some fixes - better log display when importing from theme's files - tested on WP 2.9-rare
-**0.9.8**
-verified on official WP 2.8 - see Notes
-**0.9.7.1**
-grouping of terms by language now possible, - better import .po - enrich terms more possible (same terms with/without html tags (0.9.7.2 : some refreshing fixes)
+= 2.0 - MAJOR UPGRADE =
+* new way of saving lines in CPT
+* use as soon as possible wp-admin UI library
+* now msg lines full commented as in .po
+* now translated lines (msgstr) attached to same taxonomy as xili-language (> 2.4.1)
+* VERY IMPORTANT : before upgrading from 1.4.4 to 2.0, export all the dictionary content in .po files and empty the dictionary table.
-THESE VERSIONS 1.0.x ARE BETA VERSION (running on our sites and elsewhere) - WE NEED MORE FEEDBACK even if the first from world are good - coded as OOP and new admin UI WP 2.7 features (meta_box, js, screen options,...)
-
-Some features (importing themes words to fill msgid list) are not totally stable (if coding is crazy - too spacing !)...
+For previous versions, see Changelog and readme in tab Other Versions.
== Installation ==
1. Upload the folder containing `xili-dictionary.php` and language files to the `/wp-content/plugins/` directory,
2. Verify that your theme is international compatible - translatable terms like `_e('the term','mytheme')` and no text hardcoded -
-3. active and visit the dictionary page in tools menu ... more details soon... [here](http://dev.xiligroup.com/?cat=394&lang=en_us) -
+3. Activate and visit the dictionary page in tools menu and docs [here](http://dev.xiligroup.com/xili-dictionary/) -
+4. To edit a msg, you can start from dictionary list or XD msg list using current WP admin UI library. Don't forget to adapt UI with screen options and moving meta boxes.
+
+More infos will be added progressively in a wiki [here](http://wiki.xiligroup.org/index.php/Main_Page).
== Frequently Asked Questions ==
-= Is the term msgid may contain words enriched by html tags ? =
-like `<em> or <strong>`
-
-Yes, since version 0.9.7.
+= What about WP multisite (or network - former named WPMU) and the trilogy ? =
+[xili-language](http://wordpress.org/extend/plugins/xili-language/), [xili-tidy-tags](http://wordpress.org/extend/plugins/xili-tidy-tags/), [xili-dictionary](http://wordpress.org/extend/plugins/xili-dictionary/)
-`
-a <strong>good</strong> word
-`
-
-can be translated by
-
-`
-un mot <strong>exact</strong>
-`
-
+Since WP 3.0-alpha, if multisite is activated, the trilogy is compatible and will include progressively some improvements dedicaded especially for WP network context. Future specific docs will be available for registered webmasters to describe where mo files where saved.
= Where can I see websites using this plugin ? =
-dev.xiligroup.com [here](http://dev.xiligroup.com/ "a multi-language site")
+More than 3000 websites use xili-language (according peak of version updates in stats).
+
+dev.xiligroup.com [here](http://dev.xiligroup.com/ "a multi-language site"),
+multilingual.wpmu.xilione.com [here](http://multilingual.wpmu.xilione.com/ "a multi-language demo site")
and
www.xiliphone.mobi [here](http://www.xiliphone.mobi "a theme for mobile") also usable with mobile as iPhone.
= What is the difference with msgid and msgtr in .po file ? =
The msgid line is equal to the term or sentence hardcoded in the theme functions like ` _e() or __() `. msgstr is the translation in the target language : by instance `fr_FR.po` for a french dictionary. (the compiled file is `fr_FR.mo` saved in the theme folder.
-The root language is in Wordpress currently `en_US`, but with xili-dictionary, it is possible to create a `en_US.mo` containing the only few terms that you want to adapt.
+The root language is in Wordpress currently `en_US`, but with xili-dictionary, it is possible to create a `en_US.mo` containing the only few terms that you want to adapt or modify.
= Is xili-dictionary usable without xili-language to edit .po or .mo file ? =
-With certain conditions, the language must in the default list and if the language files are not in the root of the current theme, you must add this line in functions.php file of this theme (normally set before xili-language is installed) :
-
-`define('THEME_LANGS_FOLDER','/nameoflangfolder'); // in Fusion: /lang`
+Yes and now automatically detected ! For example, to modify the results of a translation for your site with your words.
= What about plural translations ? =
Today works with .mo or .po with simple twin msgid msgstr couple of lines and themes with functions like ` _e() or __() ` for localization AND `_n()` which manage singular and plural terms like `msgid, msgid_plural, msgstr[0],...`
-= What about future WP 2.9 ? =
-Today works...
+= What is a po file ? =
+
+It is a text file like this (here excerpt) with different types of msgid :
+
+`
+msgctxt "comments number"
+msgid "%"
+msgstr "%"
+
+msgid "Leave a reply"
+msgstr "Laisser une réponse"
+
+msgid "One thought on “%2$s”"
+msgid_plural "%1$s thoughts on “%2$s”"
+msgstr[0] "Une réflexion au sujet de « %2$s »"
+msgstr[1] "%1$s réflexions au sujet de « %2$s »"
+
+msgctxt "sentence"
+msgid "comment"
+msgid_plural "comments"
+msgstr[0] "commentaire"
+msgstr[1] "commentaires"
+
+`
+
+= What happens if only the .mo is available ? =
+
+xili-dictionary is able to import a .mo of the target language and rebuild a .po editable in backend or a text editor. Example: if it_IT is in your language list, it_IT.mo can be imported, completed by webmaster and export as it_IT.po text file in languages sub-folder of the theme (as text backup).
+
+
== Screenshots ==
-1. the admin settings UI and boxes for editing, sub-selection and create or import files (.mo or .po).
-2. Since 1.0.0, plural terms are allowed.
-3. MsgID with his singular and his plural line.
-4. MsgSTR with separators between occurrences of n plural terms `msgstr[n]` (soon more practical UI).
+1. The admin settings UI: table for sub-selection and create or import files (.mo or .po).
+2. Msg edit screen with the msg series dashboard.
+3. Msg list table screen as designed with WP admin UI library.
+4. MsgID with his singular and his plural line.
+5. MsgSTR with his plural.
== Upgrade Notice ==
-Upgrading can be easily procedeed through WP admin UI or through ftp.
-
+Upgrading can be easily procedeed through WP admin UI or through ftp (delete previous release folder before upgrading via ftp).
+IMPORTANT - Don't forget to backup before.
+Verify you install latest version of trilogy (xili-language, xili-tidy-tags,…).
+IMPORTANT - Before updating to xili-dictionary 2.0, export all the dictionary contents in .po files foreach target langs and empty the dictionary table made by 1.4.4.
== More infos ==
This first beta releases are for theme's creator or designer with some knowledges in i18n.
-The plugin post is frequently updated [dev.xiligroup.com](http://dev.xiligroup.com/?p=312 "Why xili-dictionary ?")
+The plugin post is frequently updated [wiki.xiligroup.org](http://wiki.xiligroup.org/index.php/Category:Xili-dictionary_plugin)
+
+See [dev.xiligroup forum plugins forum](http://forum2.dev.xiligroup.com/forum.php?id=3).
-See also the [Wordpress plugins forum](http://wordpress.org/tags/xili-language/).
+See also the [Wordpress plugins forum](http://wordpress.org/tags/xili-dictionary/).
+
+© 2009-2012 MS - dev.xiligroup.com
== Changelog ==
-= 1.0.3 beta =
-fixes some directories issues in (rare) xamp servers and in theme's terms import. Create .po with empty translations.
-= 1.0.2 beta =
-Use POMO libraries and classes only in WP > 2.8. Add plural translations. Add edit term dynamic UI
-= 0.9.9 =
-* fixes existing msgid terms -
-* better log display in importing theme's terms
-* more html tags in msg str or id
-= 0.9.8 =
-* verified on official WP 2.8.
-* fixes query error,
-* .1 fixe IIS error.
+= 2.2.0 (2012-09-29) =
+* fixes issues of 2.1 series (messages, import, conditions, and more…).
+* 2.1.2 and 2.1.3 removed from repository
+= 2.1.3 (2012-08-20) =
+* fixes
+= 2.1.2 (2012-07-15) =
+* list of untranslated msgs in edit msg screen.
+* shortcut in side metabox to update .mo of current lang. See [xili wiki](http://wiki.xiligroup.org/index.php/Xili-dictionary:_what%27s_new_since_version_2.1.2 "Wiki")
+* fixes local-xx_XX import - new icons
+= 2.1.0 (2012-05-08) =
+* in multilingual website context, requires version 2.6 of xili-language.
+* local datas saved in local-xx_XX .mo/po files.
+* origin taxonomy used to manage one dictionary with multiple themes.
+* see [xili wiki](http://wiki.xiligroup.org/)
-= 0.9.7.2 = some fixes
-= 0.9.7.1 = list of msgid ID at end
-= 0.9.7 = grouping of terms by language now possible, and more...
-= 0.9.6 = W3C - recover compatibility with future wp 2.8
-= 0.9.5 = sub-selection of terms in UI, better UI (links as button)
-= 0.9.4.1 = subfolder for langs file - ` THEME_LANGS_FOLDER ` to define in functions.php with xili-language
-= 0.9.4 = second public release (beta) with OOP coding and new admin UI for WP 2.7
+= 2.0.0 =
+* 120417 - repository as current
+* 120405 - pre-tests with WP 3.4: fixes metaboxes columns
+* 120219 - new way of saving lines in CPT - new UI using WP library
+* now msg lines full commented as in .po
+* now translated lines (msgstr) attached to same taxonomy as xili-language
+* compatible with theme and language files in sub-sub-folder.
+* IMPORTANT - before upgrading from 1.4.4 to 2.0, export all the dictionary in .po files and empty the dictionary.
+
+= beta 1.4.4 =
+* 111221 - fixes
+* between 0.9.3 and 1.4.4 see version 1.4.4 - 20120219
= 0.9.3 = first public release (beta)
-© 100207 - MS - dev.xiligroup.com
+© 20120922 - MS - dev.xiligroup.com