Sngine v2+ - Documentation

Getting Started

Welcome

Sngine v2+ is a Social Network Platform is the best way to create your own social website or online community. Launch it in just 1 minute with ultimate features. It’s easy to install

If you have any questions that are beyond the scope of this documentation, please feel free to create a support ticket on our support system. Thanks so much!

License

To install Sngine or even to open a support ticket you must know your Purchase Code of Sngine and to get your Purchase Code

  • Login to Codecanyon and open your downloads http://codecanyon.net/downloads
  • Click on the download button of Sngine v2 and download License certificate & purchase code You can download it as a PDF or text file
  • You will find your code as the following

Installing

No coding or design skills needed. Launch in 1 minute

  • This script requires Apache Server, PHP 5.4+ and MySQL 5.0+ to run.
  • Before install Sngine please make sure that mod_rewrite, cURL and mail() are enabled on your server. you can ask your hosting company to make sure to enable it for you. But don't worry Sngine will check for all of them before installing begins
  • Now make sure you create a empty MySQL database along with an user for it.
  • After unzip Sngine Files, you will found Script Folder
  • Start your FTP client (I persoanlly use Filezila which is free) and login. Login to your server. You will need your host name (often times this will be your domain name), username, and password that you setup with the hosting company.
  • Locate the domain folder you wish to upload your Sngine files to on your server. You are going to upload all files located in Script Folder to your FTP client.
  • Once the files are done uploading, you have to change chmod of content/uploads folder and content/themes/default/templates_compiled folder to 777.
  • Just goto your website and Sngine installer wizard will run automatically http://yourdomain.com/path_to_script
  • Sngine installer wizard is very clean, you will need to put your Purchase Code at step #2 and the rest is simple just follow the video tutorial
  • And That's it, Have Fun :)

Socail Logins

Facebook

After installing Sngine now you can in easy step integrate Facebook with it to let your users login with their Facebook accounts.

  • First goto: https://developers.facebook.com and Sign in with your Facebook account.
  • Now click My Apps and click Add a new App
  • Fill the form and click Create App ID
  • App still not Public and to make the App Public you must enter a contact email from Settings page
  • Goto to App Review and switch the toggle button to make the App Public and Confirm
  • Now copy your App ID and App Secert and goto to your Sngine Admin panel and open your settings page and paste both keys as shown.
  • That's all, Enjoy!

Twitter

After installing Sngine now you can in easy step integrate Twitter with it to let your users login with their Twitter accounts.

  • First goto: https://apps.twitter.com/ and Sign in with your Twitter account.
  • Click Create New App and fill the form (Leave Callback URL blank)
  • Now back to your app page and open Keys and Access Tokens tab to copy both Consumer key and Consumer secret.
  • Now goto to your Sngine Admin panel and open your settings page and paste both keys as shown.
  • That's all, Enjoy!

Google

After installing Sngine now you can in easy step integrate Google with it to let your users login with their Google accounts.

  • Go to https://code.google.com/apis/console/ and create a new project.
  • Click on Enable and manage APIs
  • Click on Credentials and Click on OAuth consent screen tab and fill the form and Save
  • Back to Credentials tab and click on Create credentials and choose Oauth client ID
  • Set Application type to Web application and Provide these URIs as the Authorized redirect URIs for your application as following:
    If you installed Sngine in your domain directly like domain.com the URIs should be like these:
    http://www.domain.com/connect/google
    http://www.domain.com/oauth.php?hauth.done=Google
    If you installed Sngine in sub-domain like sub.domain.com the URIs should be like these:
    http://sub.domain.com/connect/google
    http://sub.domain.com/oauth.php?hauth.done=Google
    If you installed Sngine in a directory like domain.com/directory the URIs should be like these:
    http://www.domain.com/directory/connect/google
    http://www.domain.com/directory/oauth.php?hauth.done=Google
  • Once you have registered, copy the created application credentials (Client ID and Secret)
  • The last thing, You will need to enable Google+ API goto Overview tab
  • Now goto to your Sngine Admin panel and open your settings page and paste both Client ID and Secret as shown.
  • That's all, Enjoy!

Linkedin

After installing Sngine now you can in easy step integrate Linkedin with it to let your users login with their Linkedin accounts.

  • First goto: https://www.linkedin.com/developer/apps and Sign in with your Linkedin account.
  • Click Create Application and fill the form
  • Goto the Settings page and change Application Status to make it live and Update
  • Now back to your Authentication page to copy both Authentication Keys.
  • Now goto to your Sngine Admin panel and open your settings page and paste both keys as shown.
  • That's all, Enjoy!

Vkontakte

After installing Sngine now you can in easy step integrate Vkontakte with it to let your users login with their Vkontakte accounts.

  • First goto: http://vk.com/dev and Sign in with your Vkontakte account.
  • Click Create an Application and fill the form
  • Now back to your Settings page to copy both Application ID and Secure key.
  • Now goto to your Sngine Admin panel and open your settings page and paste both keys as shown.
  • That's all, Enjoy!

Mobile Apps

Android App

  • Import your APP into Android Studio
  • Change App Name - Open "Andriod\Sngine\app\src\main\res\values\strings.xml"
  • Change your website link from both files "Andriod\Sngine\app\src\main\java\com\example\app\MainActivity.java" and "Andriod\Sngine\app\src\main\java\com\example\app\MyAppWebViewClient.java"
  • Change App Icon from "Andriod\Sngine\app\src\main\res\drawable-*"
  • Export your APK
  • That's all, Enjoy!

IOS App

  • Import your APP into XCode
  • Change your website link
  • Change your App name
  • Change your App icons
  • Change your App Splash Screens
  • That's all, Enjoy!

Windows Phone App

  • Open Sngine.sln with Visual Studio 2015
  • Change your App name
  • Change your website link
  • Change your App icons and Splash Screens
  • That's all, Enjoy!

Sngine APIs

Our API allows you to retrieve informations from y website via GET request and supports the following parameters:

Field Description
get This parameter specify the type of the query:
  • users is for user profile informations
  • pages is for pages informations
  • groups is for groups informations
query The query string

Get Users

Allow you to retrive the user info

Example of requests: 
[GET] http://demo.sngine.com/api.php?get=users&query=USERNAME
Example of response: 
[user_id] => 1
[user_name] => Yehia Abed
[user_fullname] => d3veloper
[user_gender] => M
[user_picture] => http://demo.sngine.com/content/themes/default/images/blank_profile_male.jpg
[user_cover] => 
[user_registered] => 2016-02-14 14:56:57
[user_verified] => 1

An example of json decoding would be the following PHP code: 

<?php
header('Content-Type: text/plain; charset=utf-8;'); 
$file = file_get_contents("http://demo.sngine.com/api.php?get=users&query=USERNAME");
print_r(json_decode($file));
?>

Get Pages

Allow you to retrive the page info

Example of requests: 
[GET] http://demo.sngine.com/api.php?get=pages&query=USERNAME
Example of response: 
[page_id] => 1
[page_admin] => 1
[page_category] => 1
[page_name] => sngine
[page_title] => sngine
[page_picture] => http://demo.sngine.com/content/themes/default/images/blank_page.png
[page_cover] => 
[page_description] => ss
[page_verified] => 0
[page_likes] => 0

An example of json decoding would be the following PHP code: 

<?php
header('Content-Type: text/plain; charset=utf-8;'); 
$file = file_get_contents("http://demo.sngine.com/api.php?get=pages&query=USERNAME");
print_r(json_decode($file));
?>

Get Groups

Allow you to retrive the group info

Example of requests: 
[GET] http://demo.sngine.com/api.php?get=groups&query=USERNAME
Example of response: 
[group_id] => 1
[group_admin] => 1
[group_name] => sngine
[group_title] => sngine
[group_picture] => http://demo.sngine.com/content/themes/default/images/blank_page.png
[group_cover] => 
[group_description] => ss
[group_verified] => 0
[group_members] => 0

An example of json decoding would be the following PHP code: 

<?php
header('Content-Type: text/plain; charset=utf-8;'); 
$file = file_get_contents("http://demo.sngine.com/api.php?get=groups&query=USERNAME");
print_r(json_decode($file));
?>

If you have any questions that are beyond the scope of this documentation, please feel free to create a support ticket on our support system. Thanks so much!