Trac
 
 

General Ray FAQ

How can I replace Free Ray widgets with Ad-Free ones (and vice versa)?

How can I translate my widgets?

How do I register Ray widgets with different licenses?

How can I replace Free Ray widgets with Ad-Free ones (and vice versa)?

You can do it this way:

1) replace the following folders and files:

ray/modules/WIDGET_NAME/app
ray/modules/WIDGET_NAME/inc/constants.inc.php
ray/modules/WIDGET_NAME/xml/main.xml

with those from the Dolphin AdFree/Free package (WIDGET_NAME stands for the real name of the widgets you wish to replace) overwriting the existing files; for example:

replace ray/modules/board/app in your Free package with ray/modules/board/app from the Ad-Free package

2) set the following permissions (via an FTP or SSH client):

chmod 777 ./ray/modules/board/files/ ./ray/modules/im/files/ ./ray/modules/mp3/files/ ./ray/modules/movie/files ./ray/modules/music/files ./ray/modules/global/app/ffmpeg.exe
	  
chmod 666 ./ray/modules/global/xml/config.xml ./ray/modules/global/xml/main.xml ./ray/modules/board/xml/config.xml ./ray/modules/board/xml/langs.xml ./ray/modules/board/xml/main.xml ./ray/modules/board/xml/skins.xml ./ray/modules/chat/xml/config.xml ./ray/modules/chat/xml/langs.xml ./ray/modules/chat/xml/main.xml ./ray/modules/chat/xml/skins.xml ./ray/modules/im/xml/config.xml ./ray/modules/im/xml/langs.xml ./ray/modules/im/xml/main.xml ./ray/modules/im/xml/skins.xml ./ray/modules/presence/xml/config.xml ./ray/modules/presence/xml/langs.xml ./ray/modules/presence/xml/main.xml ./ray/modules/presence/xml/skins.xml ./ray/modules/video/xml/config.xml ./ray/modules/video/xml/langs.xml ./ray/modules/video/xml/main.xml ./ray/modules/video/xml/skins.xml ./ray/modules/mp3/xml/config.xml ./ray/modules/mp3/xml/langs.xml ./ray/modules/mp3/xml/main.xml ./ray/modules/mp3/xml/skins.xml ./ray/modules/movie/xml/config.xml ./ray/modules/movie/xml/langs.xml ./ray/modules/movie/xml/main.xml ./ray/modules/movie/xml/skins.xml ./ray/modules/music/xml/config.xml ./ray/modules/music/xml/langs.xml ./ray/modules/music/xml/main.xml ./ray/modules/music/xml/skins.xml ./ray/modules/desktop/xml/config.xml ./ray/modules/desktop/xml/langs.xml ./ray/modules/desktop/xml/main.xml ./ray/modules/desktop/xml/skins.xml ./ray/modules/shoutbox/xml/config.xml ./ray/modules/shoutbox/xml/langs.xml ./ray/modules/shoutbox/xml/main.xml ./ray/modules/shoutbox/xml/skins.xml

3) Enter your Admin Panel and register the Ad-Free widgets in Plugins -> Ray Suite.

4) Please consider that if you replace Free Chat, IM, Boards and Video Recorder with their Ad-Free versions, you won't be able to use BoonEx RMS anymore. You will have to install your own RMS. Here you can learn the RMS installation instructions.

5) Clear the cache of your browser and test the widgets again.


How can I translate my widgets?

There are language files in every of your widgets. They are located in the folders ray/modules/WIDGET_NAME/langs. The default language is English and its language file is called english.xml.

To create more languages, you need to translate the default language file and save it with a different name, for example, french.xml. You need to translate the words and expressions inside the CDATA elements, for example in [CDATA[Visit]] - you need to translate Visit. You need to use a UTF-8 supporting editor to translate the file, for example Notepad++.

Then you will have to log into Admin Panel -> Plugins -> Ray Suite -> WIDGET_NAME -> Languages and choose a new Default language.

Your members can now switch the language of the widget by clicking the Settings icon in the widget's window.


How do I register Ray widgets with different licenses?

1) If you're not going to switch to Free/Ad-Free license when you already have Ad-Free/Free one respectively, you need to edit the file ray/modules/WIDGET_NAME/xml/main.xml and remove the LICENSE_NUMBER from the <item key="license"><![CDATA[LICENSE_NUMBER]]></item> statement.

Now navigate to Admin Panel -> Plugins -> Ray Suite and register all the widgets that show Register prompt.

2) If you're going to switch to Free/Ad-Free license when you already have Ad-Free/Free one, please follow the instructions here.