LaraClassified

Geo Classified Ads CMS

Many thanks for your purchase. For a quick and easy installation we created for you this technical support. Please use the left navigation bar to browse through this support. Let’s go !

Installation

Introduction

Before install make sure you have the proper server requirements

PHP 5.5.9 or greater
GD or Imagick
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Tokenizer PHP Extension
PHP Fileinfo extension

File and folder permissions

/bootstrap        775
/database         775
/public/uploads   775
/storage          775

Installation with Apache

Before installing, make sure mod_rewrite is enabled.

Unzip the source file

cd /home/user/
unzip codecanyon-16458425-laraclassified-geo-classified-ads-cms.zip

Put the LaraClassified source folder (from v1.0 to v1.6 => all the files in main/) into your webroot. For example, if your LaraClassified source is located at /home/user/LaraClassified, you can configure Apache virtual host as follows (remember to point the DocumentRoot to the public folder of the source)

<VirtualHost *:80>
  ServerName yoursite.com
  DocumentRoot "/home/user/LaraClassified/public"
  Options Indexes FollowSymLinks
  <Directory "/home/user/LaraClassified/public">
    AllowOverride All
    Require all granted
  </Directory>
</VirtualHost>

Change the director/file’s owner to Apache’s running user (www-data for example), to make sure it has proper permission on your source files

sudo chown www-data:www-data -R /home/user/LaraClassified
sudo chmod 775 -R /home/user/LaraClassified

Then restart Apache.

Now go to the webapp’s installation URL. For example http://yoursite.com/install

Follow the web installation wizard and you will get LaraClassified installed on your own host.

Visit yoursite.com/admin and use Email: admin@yoursite.com / Password: 123456.

Change the email address and the password.

You are done.

Shared Hosting Install

Consider that this is the webroot folder for your LaraClassified website: /home/myusername/public_html/

Put all the main folder’s files in your LaraCalssified website at /home/myusername/

Move all the files in the folder /home/myusername/public/ to your webroot (example: public_html/ ou htdocs/) folder for your LaraClassified website at /home/myusername/public_html/

You can delete the folder /home/myusername/public/ (it is now empty)

Create MySQL database, add user to it with full permissions.

Now go to the webapp’s installation URL. For example http://yoursite.com/install

Follow the web installation wizard and you will get LaraClassified installed on your own host.

Visit yoursite.com/admin and use Email: admin@yoursite.com / Password: 123456.

Change the email address and the password.

You are done.

Installation with Nginx

Put the LaraClassified source folder (from v1.0 to v1.6 => all the files in main/) into the folder /var/www/ and set your server configuration like this:

root "/var/www/public";
location / {
   try_files $uri $uri/ /index.php?$query_string;
}

Then restart Nginx.

Now go to the webapp’s installation URL. For example http://yoursite.com/install

Follow the web installation wizard and you will get LaraClassified installed on your own host.

Visit yoursite.com/admin and use Email: admin@yoursite.com / Password: 123456.

Change the email address and the password.

You are done.

 

SMTP

What is SMTP ?

Short for Simple Mail Transfer Protocol, a protocol for sending e-mail messages between servers. Most e-mail systems that send mail over the Internet use SMTP to send messages from one server to another; the messages can then be retrieved with an e-mail client using either POP or IMAP. In addition, SMTP is generally used to send messages from a mail client to a mail server. This is why you need to specify both the POP or IMAP server and the SMTP server when you configure your e-mail application.

In short it used to send emails to your site users..!!

You can use any SMTP service provider.

Please note that some hosting providers blocks port 25 or 465 in that case you have change your SMTP email server or contact your hosting provider

Own SMTP Server

Using your own or some SMTP server

Admin panel setup

Or use /.env file setup

It will look something like this.

MAIL_DRIVER=smtp
MAIL_HOST=your-mail-host
MAIL_PORT=your-mail-port
MAIL_USERNAME=your-mail-username
MAIL_PASSWORD=your-mail-password
MAIL_ENCRYPTION=your-mail-encryption

NOTE: The .env file settings override those of the admin panel.

Mandrill

Mandrill as SMTP

Personally we use mandrill and yes it’s free

Admin panel setup

Or use /.env file setup

MAIL_DRIVER=smtp
MAIL_HOST=your-mail-host
MAIL_PORT=your-mail-port
MAIL_USERNAME=your-mail-username
MAIL_PASSWORD=your-mail-password
MAIL_ENCRYPTION=your-mail-encryption

MAIL_DRIVER=mandrill
MANDRILL_SECRET=your-mandrill-secret
MAIL_HOST=your-mandrill-smtp-host
MAIL_PORT=your-mandrill-smtp-port
MAIL_USERNAME=your-mandrill-smtp-username
MAIL_PASSWORD=your-mandrill-smtp-password
MAIL_ENCRYPTION=your-mandrill-smtp-encryption

NOTE: The .env file settings override those of the admin panel.

Amazon SES

Amazon SES as SMTP

Admin panel setup

Or use /.env file setup

MAIL_DRIVER=smtp
MAIL_HOST=your-mail-host
MAIL_PORT=your-mail-port
MAIL_USERNAME=your-mail-username
MAIL_PASSWORD=your-mail-password
MAIL_ENCRYPTION=your-mail-encryption

SES_KEY=your-ses-key
SES_SECRET=your-ses-secret
SES_REGION=your-ses-region

NOTE: The .env file settings override those of the admin panel.

Mailgun

Mailgun as SMTP

Admin panel setup

Or use /.env file setup

MAIL_DRIVER=smtp
MAIL_HOST=your-mail-host
MAIL_PORT=your-mail-port
MAIL_USERNAME=your-mail-username
MAIL_PASSWORD=your-mail-password
MAIL_ENCRYPTION=your-mail-encryption

MAIL_DRIVER=mailgun
MAILGUN_DOMAIN=your-mailgun-domain
MAILGUN_SECRET=your-mailgun-secret
MAIL_HOST=your-mailgun-smtp-host
MAIL_PORT=your-mailgun-smtp-port
MAIL_USERNAME=your-mailgun-smtp-username
MAIL_PASSWORD=your-mailgun-smtp-password
MAIL_ENCRYPTION=your-mailgun-smtp-encryption

NOTE: The .env file settings override those of the admin panel.

Payment Providers

We support these payment providers:

Paypal is one of the best payment gateway in the world, it support all credit cards and accepted in many countries.

Paypal

Please note that this support is for the Sandbox mode. 

Admin panel setup

Or use /.env file setup

PAYMENT_PROVIDER=paypal
PAYPAL_USERNAME=yourPayPalBusinessEamil@something.com
PAYPAL_PASSWORD=YourPassword
PAYPAL_SIGNATURE=YourSignatrue
NOTE: The .env file settings override those of the admin panel.

Social Keys

In this section we will configure Social API key for.

Before that make sure you have valid account for these social networks.

You have to setup your admin panel :

Or place all the config values and api keys in the .env file.

Facebook Example in .env file

FACEBOOK_CLIENT_ID=your-facebook-client_id
FACEBOOK_CLIENT_SECRET=your-facebook-client_secret

Google Example in .env file

GOOGLE_CLIENT_ID=your-google-client_id
GOOGLE_CLIENT_SECRET=your-google-client_secret

 

NOTE: The .env file settings override those of the admin panel.

Facebook

Create your Facebook App

Admin panel setup

Or use /.env file setup

FACEBOOK_CLIENT_ID=your-facebook-client_id
FACEBOOK_CLIENT_SECRET=your-facebook-client_secret

Google

Google OAuth Client ID

Admin panel setup

Or use /.env file setup

GOOGLE_CLIENT_ID=your-google-client_id
GOOGLE_CLIENT_SECRET=your-google-client_secret

Google Maps Embed API

Admin panel setup

Or use /.env file setup

GOOGLE_MAPS_API_KEY=your-googlemaps-key

Google Maps API Key

Captcha

Recaptcha Key

What is recaptcha

reCAPTCHA is a free CAPTCHA service that helps protect your site against spam, malicious registrations and other forms of attacks where computers try to disguise themselves as a human. reCAPTCHA comes in the form of a widget that you can easily add to your blog, forum, registration.

How to setup.

Admin panel setup

Or use /.env file setup

RECAPTCHA_PUBLIC_KEY=your-recaptcha-public_key
RECAPTCHA_PRIVATE_KEY=your-recaptcha-private_key

NOTE: The .env file settings override those of the admin panel.

Image Processing

Image Setting

We support for two image processor.

GD is very basic image resizing driver for PHP and only to used on basic website. It has memory issues and doesn’t perform well at all conditions.

If you want your site for pro-photography or better quality images we prefer you to use imagick instead for better quality results.

Please make sure that your server has imagick installed.

Imagick

First make sure that you have imagick installed on your server, if not then contact your hosting provider.

Search

IMAGE_DRIVER=gd

Change it to

IMAGE_DRIVER=imagick

Clear Cache

Clear All Image Cache

Caution..!! Your site might face down time until all images are re-cached

For those who are not using cloud CDN

For those who using cloud CDN

Memory Settings

Image manipulation in PHP is a very memory consuming task. Since most tasks in PHP don’t exhaust default memory limits, you have to make sure your PHP configuration is able to allocate enough memory to handle large images.

The following php.ini directives are important.

memory_limit

Sets a maximum amount of memory in bytes that a script is allowed to allocate. Resizing a 3000 x 2000 pixel image to 300 x 200 may take up to 32MB memory.

upload_max_filesize

If you’re planing to upload large images, verify that this setting for the maximum size of file uploads fits your needs.

Read more in the official PHP documentation for:

It’s possible to set these directives in your php.ini or at runtime with ini_set.

Geo Location

How can I enable Geo location?

How To

How can I set the Default country?

How can I set the Default currency?

How can I setup my paypal account?

How can I setup the packs/Plans?

How can I setup the advertising code (e.g. Adsense)?

How can I setup Recaptcha?

More options doc coming soon…

Languages

How can I add new languages?

How can I edit languages information (e.g. Name, Abbr, etc.)?

How can I edit translations?

How can I change the default language?

How can I disable languages?

How can I delete languages?

Debug Mode

Debug mode will help you to track the error on your website. It is not all preferred to turn the debug mode on live site for very long time.

How to turn debug mode on

Change

APP_DEBUG=false

To

APP_DEBUG=true

false means debug mode is OFF
true means debug mode is ON