crea8SOCIAL DOCUMENTATION

# crea8SOCIAL

## PHP SOCIAL NETWORKING PLATFORM

- www.crea8social.com
- email: procrea82014@gmail.com

### Requirements

The following are the requirements your sever must have

- PHP 5.4 and above
- MCrypt PHP Extension (This is needed for security purpose by laravel4

- ### Permissions

  It required you give the following folders write access after you upload

  - app/storage
  - uploads/
  - app/config
  - app/config/database.php
  - app/storage/
  - app/storage/session
  - app/storage/logs/laravel.log
  - uploads/ -- if the folder no exists create it

- ### Pretty Urls

  Make sure mod_rewrite is enabled on your server

  If the .htaccess that is included does not work please see FAQ

### Installation

crea8SOCIAL installation is just two steps you can watch the video here Installation Demostration

### UPLOAD THE MAIN FILES

- Unzip the download files
- You will see the folder named "main"
- Upload the content to your web root

### Create Database

- Create databasse with the method your server provided, mostly through PHPmyAdmin and take note of the following
- - Database name
  - Database user
  - Database password
  - Database host

### Now run your website and follow the simple steps the interface provided

If you have problem from here please see the FAQ below

### Setting Up Your Website

After a successfull installation from the above process, it is required you setup your admin panel

- Login to your admin panel by following this link www.yoursite.com/admincp
- Login with the details you created durring the installation
- Go to configuration to manage the settings for users,pages,posts,images e.t.c
- Also Games, Pages need categories so create them

Setup Mail System

Firstly i will like you to know that mail has different issue base on the hosting company because some hosting block sending of mails by disabling the php mail function

crea8social v3.0 comes with two kind of mail driver, listed below

- Mail
- SMTP

Now Depends on the one that works for you but i will explain the one that work best

Go to admincp -> configuration -> mail

Mail Driver

If you are using the mail driver set it and other fields empty

SMTP

You can use your server smtp or other thirdparty smtp server, but i will explain Gmail Smtp Server below

Select the smtp driver

- Driver Host : gmail-smtp-in.l.google.com
- Driver Port : 25
- Driver Encryption : None
- From Address : Set your site email
- From Name : Set from name
- SMTP Username : Gmail username
- SMTP Password : Gmail Password

If you can't get it, check the example on the demo or contact me. Thanks

### Theme System

The themes are located in the themes/ folder

We have admincp and frontend themes, inside each folder you with themes and from there you can add yours

You can also create your themes, by just duplicating the default theme and start edit its css, html, and javascript

### Page Design

From the theme you can add more page design templates for your member, check the option.php file

### Manage Emoticons

Also through the themes you can add more emoticons for your members to select

### Laanguage Translations

### Language folders

All languages translation are located at app/lang/

The system comes with English Language which you can find in the folder en/

### Add a new language

To add new languages is simple, inside the lang/ folder

- create a new folder call "fr" for French language
- Copy the files in lang/en/ into your new folder lang/fr/
- Open each of the files to change there value to french translation
- Once you are done with that, now go to admincp to add the new language

- ### Follow this

  - Manage translation -> Add languages
  - For this example the language var is "fr"
  - The language name is French Language
  - Thats all your members can now change language at the frontend

### Social Login Setup

Currently crea8social only support facebook,twitter and vk login

So to set each of them up, you need to create your website app on each of them to get the Key and the Secret

Once you have getting the keys and the secret, following the instruction below

- Go to admincp ->configurations -> socialauth
- There you can set the key and secret value for each of them

- #### Also you will need to setup callback/domain url for facebook, just use your website url

For Google Setup

Create your application on google to get your APP Client ID and Client Secret and set it at admincp -> configurations -> socialauth

Go to the app settings and set your domain

Also set the AUTHORIZED REDIRECT URIS to this url
http://your-site-url/auth/google
Make sure to change your-site-url to your domain name e.g example.com

### Addons

Addons allows you to add more features to your social network with a knowledge of PHP,HTML,CSS e.t.c,

### Manage Configurations

All configurations can be found on the admincp,, allows you to change the following

- Maximum upload photo/image size
- Enable/disable account activation
- and e.t.c

### Manage Ads

crea8SOCIAL comes with two ads position, the banner and the side ads

To manage it go to admincp -> manage ads

The first field is for banner ads, you can place your banner codes there.

For the second one is for the side bar ads

### Setup AutoTranslator Addon

This addon uses translate.yandex.com api to translate non-english text in posts

So you need to get the service API Key before you can use it

Go to http://api.yandex.com/translate/

- Register and get your key
- Now go to your site admincp -> addons management -> autotranslator -> configurations -> paste the key and click save
- You are done

### Add Google Analytics Code

Its simple to add google analytics code to your crea8social website

Go to admincp -> configurations -> general -> add Google Analytics code

### Manage Games

I added this little tutorial on how to add games for your member because of so many questions about it

Please there are two ways to add games to your website

- 1. From admincp
- 2. From the frontend

You have the option to disable the games system entirely or disable adding of games from frontend @admincp -> configurations -> games

NOTE: Please note that allowing your members to add games may be risky because they can add rubbish as game, since games are not uploaded to your site, there is no way you can detect if the game is valid

But there is another option that allowed you to approve games added by your members from the frontend @admincp -> configurations -> games

To add games is simple, just find any embeddable games site and copy the embed code and paste it in the content field when adding games Below is a list of possible websites to get games

- http://www.embeddablegames.net/
- And you can get more on google.

### FAQ

If you get the following errors, please do as the solutions stated

- INPUT NOT SPECIFIED

  Please replace the content in .htaccess file with this below, if it does not work be contact me

                              Options +FollowSymLinks
                              RewriteEngine On

                              RewriteCond %{REQUEST_FILENAME} !-d
                              RewriteCond %{REQUEST_FILENAME} !-f
                              RewriteRule ^ index.php [L]

- Unexpected "," on line 1

  Please upgrade your PHP version to 5.4+

### HOW TO UPDATE

To update is simple, I have take my time to noted all files you need to update, add or remove

So, Go to the newly download file, extract it, the main.zip file

- You will see a folder called upgrade-info, open it and click on the last version to see the files you need to update
- Please take note of the last version you updated last, so that you can start from. For example

  If your updated version is 1.1

- You have to upgrade to 1.2 before 1.2.1
- This is done by just following the instruction in each file
- Go open the version text file you want to update to

  Inside you will see files you need to update, i give the path for easy navigation

  The files you need to add, if you can't see any that means you are not adding any new file in that version

- So after this Go to admincp -> update database

  Also Go to admincp -> configurations -> update configuration

- Now you are done, you can now navigate to your site to see the update. Thanks

### Thanks

Thanks for purchasing crea8SOCIAL, am very grateful, and to let you know expect more features in future updates. Thanks