PHPmotion Wiki : MembersToolbar

HomePage :: Contents :: PageIndex :: Login/Register

Installing Members Chat Tool Bar - Power Tool


Members Chat ToolBar


Back to Installation

Featured PHPmotion Sponsor: Cirtex- Unlimited PHPmotion Web Hosting $2.95/month [50% discount with coupon code "phpmotion"]



Before you begin


Before you start installing the Members Chat Tool Bar make sure you have done the following

- Downloaded the most recent version at: PHPmotion Forum
- Ordered and received our copy of the license file



General Instructions



1) Unpacking and Uploading

  • Unzip the downloaded file onto your computer. You will now have a folder called memberstoolbar
  • Upload this whole folder into your FTP into the addons folder. You should now have a structure like /addons/memberstoolbar
  • Upload your license file using FTP into /addons/memberstoolbar/license_mtb.php




  • NB: The following files must be uploaded in BINARY MODE
  • /ajax_chat.php
  • /ajax_env.php
  • /ajax_feed.php
  • /ajax_rooms.php
  • /config.inc.php
  • /setup.php




  • 2) Run the Setup Script (very important)

    Open your website in a web browser to the example url (http://www.yourdomain.com/addons/memberstoolbar/setup.php). Follow instructions.

    If the setup tells you to CHMOD folders, the following folders must be CHMOD to 777
  • /addons
  • /addons/memberstoolbar
  • /addons/memberstoolbar/data


  • 3) Delete unwanted files

    When you have finished setup, delete the following files

  • /addons/memberstoolbar/setup.php





  • Additional Instructions





    Editing your main template file


    You will now need to edit your main template file.

    INSTRUCTION (1): Depending on which version of PHPmotion you are running the main template file will be as follows:
    ------------------------------------------------------------------------------------------------------------------
    
    V2 Users
    --------
    /templates/main_1.htm   
    
    						 
    
    V3 Users (default theme)
    ------------------------
    /themes/default/templates/main_1.htm  
    
    
    V3 Users (custom theme)
    ------------------------
    /themes/YOUR-THEME-FOLDER(e.g. zendo)/templates/main_1.htm  




    Editing the <head></head> section


    Once you have found the main template file, download it with your FTP and edit as follows (use a plain text editor like notepad)

    INSTRUCTION (2): Add this code just before the closing </head> tag
    ---------------------------------------------------------------------------------------------------------------
    
    
    <!-- Members ToolBar - Start (place this as thelast item im head)-->
    <script type="text/javascript">
    
    var mtb_sub_folder_installation = '';
    
    
    var mtb_base_url = Base_SiteUrl()+mtb_sub_folder_installation+"/addons/memberstoolbar/";
    var mtb_base = Base_SiteUrl();
    function Base_SiteUrl(){  
    	 var url = window.location.href;  
    	 url = url.replace("http://", "");	
    		
    	 var urlExplode = url.split("/");  
    	 var serverName = urlExplode[0];  
    		
    	 serverName = "http://"+serverName;  
    	 return serverName;  
    } 
    </script>
    <link href="[var.base_url]/addons/memberstoolbar/css/main.css" rel="stylesheet" type="text/css" />
    <script type="text/javascript" language="javascript" src="[var.base_url]/addons/memberstoolbar/javascripts/jquery.js"></script>
    <script type="text/javascript" language="javascript" src="[var.base_url]/addons/memberstoolbar/javascripts/jquery.livequery.js">
    </script>
    <script type="text/javascript" language="javascript" src="[var.base_url]/addons/memberstoolbar/javascripts/toolbar.config.js"></script>
    <script type="text/javascript" language="javascript" src="[var.base_url]/addons/memberstoolbar/javascripts/toolbar.js"></script>
    <!-- Members ToolBar - End -->




    NOTE: If you have installed PHPmotion in a sub-folder (i.e. http://www.yourdomain.com/videos ) you will need to change the line above:

    var mtb_sub_folder_installation = '';
    
    
    Change it to show your subfolder
    --------------------------------
    
    var mtb_sub_folder_installation = '/yoursubfolder';





    Editing the <body></body> section


    INSTRUCTIONS (3): Add this code just before the closing </body> tag
    -------------------------------------------------------------------------------------------------------------------------------
    
    <!-- Members ToolBar -->
    <script type="text/javascript" src="[var.base_url]/addons/memberstoolbar/javascripts/toolbar.inc.js"></script>
    <!-- Members ToolBar End-->



    When you have finished, reupload the file to where you downloaded it from into your FTP





    Optional Configuration changes


    You can change various aspects of the Members Tool Bar by editing the following files (instructions written in each file)





    Using The Tool Bar



    Your members will now see the tool bar whenever they are logged into your web site





    Common Installation Errors


    The following are typical errors that you may get and they are due to having missed one of the instructions above


    Chat is not showing

    1- Firstly, make sure you are logged is as the toolbar will only come up when a user is logged in.
    2- Make sure you have done the 2 steps above (if they apply to you...i.e if you are using a custom theme) [header & footer]
    3- Make sure you have uploaded your license file (/addons/memberstoolbar/license_mtb.php)


    I get a Internal Server Error when I load the embedder

    Some server dont like CHMOD 777 (as instructed aboev). You should CHMOD any file you were told to 755 instead

    Chat bar does not stay at the bottom of the page

    We have found that some adverts code (for your bottom ads on your site) can cause this type of error. Try disabling your bottom ads




    For further help with installation you can try


    Order our installation services
    Peer support in our forum




    Valid XHTML 1.0 Transitional :: Valid CSS :: Powered by WikkaWiki
    Page was generated in 0.0516 seconds