== General Ray FAQ ==

'''[wiki:GenRayFAQs#HowcanIreplaceFreeRaywidgetswithAd-Freeonesandviceversa How can I replace Free Ray widgets with Ad-Free ones (and vice versa)?]'''

'''[wiki:GenRayFAQs#HowcanItranslatemywidgets How can I translate my widgets?]'''

'''[wiki:GenRayFAQs#HowdoIregisterRaywidgetswithdifferentlicenses 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'''[[BR]]
    '''ray/modules/WIDGET_NAME/inc/constants.inc.php'''[[BR]]
    '''ray/modules/WIDGET_NAME/xml/main.xml'''[[BR]]

    with those from the Dolphin [http://get.boonex.com/Dolphin-v.6.1-AdFree AdFree]/[http://get.boonex.com/Dolphin-v.6.1-Free 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 [http://www.boonex.com/trac/ray/wiki/RayServerInstall 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 [http://notepad-plus.sourceforge.net 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 [wiki:GenRayFAQs#HowcanIreplaceFreeRaywidgetswithAd-Freeonesandviceversa here].