Translating

The following are instructions on where to find the .pot file for this plug-in, the file name scheme to save translation files as, and location for translation files.

 1.	Look in the languages folder of the plug-in to find the .pot file. Refer to the 'wp_inline_comment_errors.pot' for the list of strings from the plug-in to be translated.  
 2.	Load the .pot into your preferred translation software, such as PoEdit, to translate these strings into your language and generate the appropriate .po and .mo files.
 3.	Save your .po and .mo files using the file name 'wp_inline_comment_errors'  followed by a dash '-' followed by the language abbreviation.  For example the file names for Spanish translation files would be named 'wp_inline_comment_errors-es_ES.po' and 'wp_inline_comment_errors-es_ES.mo'.  
 4.	Make sure to correctly name the file and place it in the languages folder or else the plug-in will not find the files and not be able to translate strings.
 5.	Please provide a copy fo the .po and .mo files to me, Hayden Porter so I can test the translation for you and also include your translation in a future version of the plug-in.  Contact me through my contact form on my web site, www.aviarts.com/contact.

Testing translation

The following are instructions for testing that your translation strings properly appear for the plug-in. Translation strings should appear in your web site on pages in the context of the comment form.  Translation strings also appear in the back end in the plug-in configuration screen.

Set Wordpress language
 1.	Download language .mo file from web.
http://translate.wordpress.org/projects/wp
 2.	Place language .mo file in wp-content > languages directory
 3.	Open config file public_html > wp-config.php
 4.	Set the language value which is the second argument of define('WPLANG', ''); to the new language.  Use the file name from the language file as the language value, such as 'es_ES' from es_ES.mo.

Install language files for the Plug-in
 1.	Place a copy of the .po and .mo files for this translation into the languages folder of the plug-in.
 2.	Make sure that the file names of the translation files are named correctly or else the plug-in will not find the files and not be able to translate strings. See the translating instructions above for more information.  

Check Translation in web pages for the Comment Form
 1.	Make sure you are logged of the back end out before testing the comment form so you can see all of the translation strings.  If you need to be both logged in and test the comment form at the same time, then use two different web browser software.
 2.	The plug-in should be functioning 'out of the box' with no custom modification. Remove any custom code using the plug-in functions so that the plug-in relies on default values only.
 3.	Visit a page within web site that has the comment form.
 4.	Submit a comment form with errors or that is incomplete to view translated strings.
 5.	The form should display a translated string similar to 'correct the following errors' and a list of translated strings, one for each form field with a problem.

Check Translation of the Plug-in Configuration Screen in the Backend
 1.	Log in to the back end.
 2.	In the 'Settings' menu, select the configuration screen for this plug-in.  Note that the name of the plug-in in the Settings menu listing should also be translated.
 3.	Translation should include the heading, footer and text for the 'WordPress Configuration' section, 'PHP Session Configuration' section, 'Defined Error Messages' section and the title of the 'Plug-in Configuration' section.
 4.	The values listed within the 'Plug-in Configuration' section should not appear as translated.  These are PHP variables values for the plug-in and should not be translated.

Test 'WordPress Configuration'  messages
There are two possible messages for this configuration section.  One indicates that the comment author must fill out name and e-mail fields.  The other indicates that the comment author is not required to fill out name and e-mail fields.  You can verify these two translation strings by changing the WordPress discussion settings and viewing the translated string on the plug-in configuration page.
 1.	Go to Settings > Discussion > Other Comment Settings and check the first box to require that the comment author must fill out name and e-mail.  
 2.	Save the changes by clicking the save button at the end of the screen.
 3.	Go back to the the plug-in configuration page, refresh the page, and verify that the translated string for this indicates that the comment author must fill out name and e-mail.
 4.	Go to Settings > Discussion > Other Comment Settings and uncheck the first box so that WordPress does not require the comment author to fill out name and e-mail. 
 5.	Save the changes by clicking the save button at the end of the screen.
 6.	Go back to the the plug-in configuration page, refresh the page and verify that the translated string indicates that comment author is not required fill out name and e-mail.

Test PHP Session Configuration messages
There are three possible messages for this configuration section.  You must change your PHP configuration to test these strings.

One message indicates that your configuration of php is set to use only cookies for sessions.  If PHP is configured this way then the plug-in will check to see if you can reconfigure PHP to support both cookies and passing session ID in the URL.  It will display a second message if you can reconfigure PHP to pass session ID in the URL query string.  If your server prevents this reconfiguration, then the second message will not appear at all.

The third possible message is that your configuration of PHP is set to use either cookies or pass session ID in the URL query string.

You will need to change your PHP configuration to test out these translation strings.
 1.	Open your PHP configuration file, php.ini
 2.	Find the line session.use_only_cookies
 3.	Set session.use_only_cookies = 1 to display the string indicating that PHP is set to only use cookies.
 4.	The secondary string is harder to test because it depends upon whether your server allows you to change this particular PHP setting using ini_set.  Your server may not allow this, so you cannot test out this translation string.
 5.	Save the php.ini and restart the server to use the new configuration.
 6.	Refresh the plug-in configuration screen to verify that the translation string indicating that PHP supports cookies only for sessions appears in the PHP configuration section.
 7.	Go back to your php.ini file, set session.use_only_cookies = 0.
 8.	Save the php.ini and restart the server to use the new configuration.
 9.	Refresh the plug-in configuration screen to verify that the translation string indicating that PHP PHP can use either cookies or pass session ID in URL string.
 10.	Be sure to restore session.use_only_cookies in php.ini to your original settings after you are done testing these translation strings.

Test Defined Error Messages
Make sure you are using an out of the box install of the plug-in and are not using any of the plug-in functions to customize the output of the plug-in.  There should be 4 translated strings, one for author, email, comment and comment duplicate messages.  The field names appearing before these 4 messages are PHP variable names and should not be translated. The note at the end of this section about custom code overriding these default messages should also be translated.