Plugin i18n

Is there a way to internationalize my plugin without modifying the original ckeditor/lang/*.js files? I don't know where to place my i18n files, how to load them, etc.

And another thing, is there a way to load plugins outside of ckeditor/plugins? I've tried using CKEDITOR.plugins.addExternal, but to no luck. The same plugin placed under ckeditor/plugins and loaded with CKEDITOR.config.extraPlugins works perfectly.

Thank you.

Fri, 09/04/2009 - 17:50

hendecasyllabic

Joined: 18/08/2009

Posts: 32

Re: Plugin i18n

I beleve that the plugins have to live in the plugin folder but you can reference in javascript files from other places.
I created this plugin which pulls in all it's bits and bobs from another area where I have some funky perl that passes the javascript thr a template toolkit like parser... long story as to why but it was necessary.

Is this any use to you?

CKEDITOR.plugins.add( 'add',
{
   init : function( editor )
   {
      var command = editor.addCommand( 'add', new CKEDITOR.dialogCommand( 'add' ) );
      command.modes = { wysiwyg:1, source:1 };
      command.canUndo = false;

      editor.ui.addButton( 'Add',
         {
            label : editor.lang.add.title,
            command : 'add'
         });

      CKEDITOR.dialog.add( 'add', '/cgi-bin/go.pl/ckfire/plugins/add/dialogs/add.js' );
   }
});

Mon, 09/07/2009 - 17:54

dondani

Joined: 03/09/2009

Posts: 2

Re: Plugin i18n

Many thanks for the example!

Still trying to find out how to internationalize my plugin...

Mon, 09/07/2009 - 18:01

hendecasyllabic

Joined: 18/08/2009

Posts: 32

Re: Plugin i18n

I think you are going to have to alter the original i18n files. tho you can cluster all your changes into their own subdivision.

Unless you want to tweak the core/lang.js

Good luck

Wed, 09/09/2009 - 22:51

alfonsoml

Joined: 31/12/2006

Posts: 3735

Re: Plugin i18n

No, each plugin can provide his own localized files, it would be a nightmare and very poor design if adding a plugin would require to change core files.

You can read the code of other plugins in the forum to learn how to do it, or read the source.

Tue, 04/20/2010 - 18:08

saul11

Joined: 19/06/2006

Posts: 633

Re: Plugin i18n

a bit more support, docs or guidelines would be highly appreciated

Tue, 04/20/2010 - 19:18

saul11

Joined: 19/06/2006

Posts: 633

Re: Plugin i18n

See for example the uicolor plugin (_source\plugins\uicolor).

Add a language file for each language in a directory 'lang' in your plugin directory:

CKEDITOR.plugins.setLang( 'myPlugin', 'en',
{
   myPlugin :
   {
      button : 'my button tooltip'
   }
});

Start your plugin with the available language codes:

CKEDITOR.plugins.add( 'imageXpert',
{
   lang : [ 'en','nl' ],

Now you can use you locales:

editor.lang.myPlugin.button