Installation & Upgrade Guide for YouNet Social Chat App on phpFox Store

Please follow all steps in this Installation & Upgrade guide in order to make this module work properly

1. Installation Guide

There are three parts in this Installation Guide, as follow:

§1.1. Installation Steps:

• Install YouNet Social Chat App on the phpFox Store.
• Run "Rebuild Core Theme" at AdminCP >> Maintenance
• Clear your cache site (at AdminCP > Maintenance >> Cache Manager)
• Set write permission to folder:
  • "PF.Base/ynchat/log/" (CHMOD: 777).
  • "PF.Base/ynchat/files/" (CHMOD: 777).
  • "PF.Base/ynchat/cache/" (CHMOD: 777).
  • "PF.Base/file/pic/ynchat_emoticon/" (CHMOD: 777).
  • "PF.Base/file/pic/ynchat_sticker/" (CHMOD: 777).
  • "PF.Base/file/ynchat/" (CHMOD: 777).
• Set permission for bash file:
  • Set execute permission for "PF.Base/ynchat/runcheck.sh"
• Create API key of "embed.ly" :
  • If you have not signed up on " https://app.embed.ly/ ". Please access " https://app.embed.ly/ " to sign-up and create a new account.
  • You can find your Embedly API key by logging in to " https://app.embed.ly " and clicking on the home tab.
  • Copy API key and paste to the module setting.

§1.2. Stop web socket or change server information

• Socket server will use specific port (default is 9009) when running. If these issues below occur:
  • Conflicting port on your server
  • Change to other port
  • Stop socket server
• Please follow these steps to fix the problem:
  • Login SSH by root account or which account can kill processes on your server
  • Go to folder "PF.Base/ynchat/" (this folder has the same level with "module" folder of phpFox)
  • Execute command "bash runcheck.sh stop <path/to/this/folder/>"
  • Note: there is a slash "/" at the end of the command above

§1.3. Setup working with SSL

• Note: your server can run with SSL first, if not please ignore below guides.
• Set-up Stunnel plugin on server in the following link:
  • http://knowledgebase.younetco.com/2014/11/19/setup-stunnel-for-younet-chat-plugin/
• Get Ports (Web Socket Port and Stunnel Port) in "Admin Panel > Apps > YouNet Chat > Settings" and update above configuration of Stunnel plugin
• Stop Web Socket

§1.4. Setup cron job (optional)

• For some reasons, i.e. server issues, user online status will not be updated in database. This cron job will help to update their status.
• Job path: .../PF.Base/ynchat/update-status.php

2. Upgrade Guide

• Upgrade our latest version.
• Run "Rebuild Core Theme" at AdminCP >> Maintenance
• Clear your cache site (at AdminCP > Maintenance >> Cache Manager)

#### Congratulations! You have finished the Installation/Upgrade process. #### If you need any assistance, please submit a new ticket at the client area (http://phpfox.younetco.com/client)