Thank you for purchasing. If you have any questions that are beyond the scope of this documentation, please feel free to contact us.

"Smile" is a fully responsive web app built with the latest technologies using the latest web trends.

It was designed with the 'viral' concept in mind but we did everything we could to make it as modular as posible so if you are creative, feel free to adapt it to your needs.

  • Responsive Design.
  • Solid Workflow having dependencies (plugins) managment with Bower, tasks automation with Gulp, make all things organised.
  • Realtime Form Validation.
  • Build with Sass CSS. Easy modification with variables.
  • Light Weight.
  • Valid HTML5 and CSS3
  • Cross Browsers
  • Developed by developers for developers (DRY, KISS, DI)
  • And much more.

Within the download zip you'll find the goodies from us

Once downloaded, unzip the compressed folder and you'll see something like this:

Smile/
├── app/
├── templates/
├── psd/
└── docs/

You'll need to put the files on a server to run it.

So you can upload the contents from "source" folder to your server to run it. Or you can setup a server locally.

What are the requirements?

Smile can be installed in both Apache and Nginx. Keep in mind that you must have PHP 5.4 or higher installed. Also, you must have mysql and php5-mysql installed. For shared hosting, these modules will come pre-installed.

I am on a VPS

If you are not on a shared hosting, you should config by yourself the machine.

Apache

You need to create a config file in your apache configuration.


NameVirtualHost *:80

<VirtualHost *:80>
  ServerName your-domain.com
  DocumentRoot /path/to/smile/public_html/public;
</VirtualHost>
            

Nginx

server {
    listen 80;
    server_name myapp.localhost.com;
    root /srv/smile/public;

    index index.html index.htm index.php;

    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    access_log off;
    error_log  /var/log/nginx/myapp-error.log error;

    sendfile off;

    client_max_body_size 100m;

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/var/run/php5-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_intercept_errors off;
        fastcgi_buffer_size 16k;
        fastcgi_buffers 4 16k;
    }

    location ~ /\.ht {
        deny all;
    }
}

Resources for nginx: How To Install Laravel with Nginx on an Ubuntu 12.04 LTS VPS

I am using shared hosting that uses cpanel

We provide a special version for users that uses Cpanel for ther hosting. It is located in source_cpanel directory.

From source_cpanel, make sure you upload the smile directory at the same level with public_html one. In public_html you should upload the files from public_html from our build.

Now what?

After that make sure you've created a mysql user with all permissions and a database and open the site in browser.

Here you'll find the installer that will make all the job for you!

start

Now lets start. On the first page you have to enter your license key but be sure you've registered the key on our site before this or it will not work!

start

As in stated in requirements page, you should provide a .env file with 777 permissions, public/uploads and storage directories should also have 777 permissions

start

Provider you database credentials and click check, then next if no errors were triggered.

start

If you want your user to have a contact page and user confirmation you should setup an email server. You can use gmail or your own server.

start

Here you should make your admin account. With this account you can authenticate on the admin panel: http://your-app.com/admin

start

In the end you need to choose what kind of installation should this be: a production installation where errors are hidden from users or a development installation where full errors logs are displayed on the page.

After installation you should add text to privacy, terms and about page that can be found in source/themes/site/resources/views/pages

Currently, we support only non-modded versions and if you want to upgrade you should delete all the files except some important ones:

The following directories and files should NOT be deleted:

1. public/uploads if you want to keep the posts media

2. public/extensions directory if you have installed modules.

3. storage/app/.license and storage/app/.installed if you want to not be asked to install the app

4. .env file because there are stored all the sensitive info about the database

After you've deleted all the old files just replace everything else with the newest files.

An auto-updater is planed but it will take time because it is a lot of work involved!

The urls are:

For facebook: http://your-site.com/auth/facebook/callback

For google+: http://your-site.com/auth/google/callback