LaraClassified

Geo Classified Ads CMS

created: 03/01/2016
latest update: 06/12/2016
by: Mayeul Akpovi
email: mayeul.a@larapen.com

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 !

Before install make sure you have the proper server requirements

PHP 5.5 or greater
GD or Imagick
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Tokenizer PHP Extension

File and folder permissions

Before Install

.env            777
.env.example    777
/storage        777
/bootstrap      777
/database       777
/public/uploads  777

After Install

.env          644
.env.example  644

Please visit here to know more about install on type of hosting your using

Cloud Server Install
Shared Hosting Install

Before install make sure you have the proper server requirements.

PHP 5.5 or greater
GD or Imagick
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Tokenizer PHP Extension

Upload and extract the main.zip in your public folder.
Visit your apache or nginx config file.

Usual default path for config files.

Apache
/etc/apache2/sites-available/000-default.conf

Nginx
/etc/nginx/sites-enabled/site-name

Change the document root to public

On apache it will look something like this

<Directory "/var/www/html/public">
    AllowOverride All
</Directory>

Nginx

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

Restart the apache or nginx
Visit yoursite.com/install to install
Visit yoursite.com/admin and use Email: admin@yoursite.com / Password: 123456.
Change the email address and the password.
You are done.

Here are links to 2 great blogs that will also help you with the install.

Before install make sure you have the proper server requirements.

PHP 5.5 or greater
GD or Imagick
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Tokenizer PHP Extension

Also take care of folder and files permissions.

Before Install

.env            777
.env.example    777
/storage        777
/bootstrap      777
/database       777
/public/uploads  777

After Install

.env          644
.env.example  644

Extra the main.zip in a folder on your computer.
Visit public folder, select all files and create zip call it zip1.zip or something you like.
Login to your cPanel or FTP upload the file to your public_html or htdocs folder and extract it.
Delete the public folder from your computer ( system )
Select all the remaing files and create new zip call it zip2.zip or anything you like.
Visit your cPanel and root directory /home/yourUserName
Upload and extract the file there.
Create MySQL database, add user to it with full permissions.
Visit yoursite.com/install and run the installer.
Visit yoursite.com/admin and use Email: admin@yoursite.com / Password: 123456.
Change the email address and the password.
You are done.

Login to your cPanel
Upload main.zip to a folder example laraclassified
Extract it, everything in laraclassified folder.
Visit sub-domain manager in your cPanel.
Change document root of your sub-domain to public.
Create empty mysql user and add user to it with full permissions.
Visit laraclassified.example.com/install to run the final installer.
Visit yoursite.com/admin and use Email: admin@yoursite.com / Password: 123456.
Change the email address and the password.
You are done.

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.

Your own hosting SMTP server
Mandrill
Amazon SES
Mailgun
Gmail, Yahoo or some other email 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

Using your own or some SMTP server

Login to your FTP account.
Open and Edit .env file.
Copy and paste your server smtp details in the file.

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

Replace your-mail-host, your-mail-port, your-mail-username, your-mail-password andyour-mail-encryption.
Save and Upload the file
You are done.
If you like test your setting check Testing STMP

Mandrill as SMTP

Personally we use mandrill and yes it’s free

Visit mandrill dashboard.
Generate a API key, via this page https://mandrillapp.com/settings/
Copy the key.
Login to your FTP account.
Open and edit .env file.
Remove

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

Change it to.

MAIL_DRIVER=mandrill
MANDILL_SECRET=your-mandill-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

Replace your-mandill-secret, your-mandill-smtp-host, your-mandill-smtp-port, your-mandill-smtp-username, your-mandill-smtp-password and your-mandill-smtp-encryption.
Save and upload the file.
You are done.
If you like test your setting please visit here Testing STMP

Amazon SES as SMTP

Login to your FTP account.
Open and edit .env file.
Remove

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

Change it to.

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

Replace your-ses-key, your-ses-secret and your-ses-region.
Save and upload the file.
You are done.
If you like test your setting please visit here Testing STMP

Mailgun as SMTP

Login to your FTP account.
Open and edit .env file.
Remove

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

Change it to.

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

Replace your-mailgun-domain, your-mailgun-secret, your-mailgun-smtp-host, your-mailgun-smtp-port, your-mailgun-smtp-username, your-mailgun-smtp-password and your-mailgun-smtp-encryption.
Save and upload the file.
You are done.
If you like test your setting please visit here Testing STMP

Testing SMTP

Login to your FTP account
Turn the Debug mode On
Visit app\Http open routes.php
Paste the below code to it just <?php tags
Make sure to replace foo@example.com in the blow code with your email address first.

Route::get('test', function(){
    Artisan::call('route:clear');
    \Illuminate\Support\Facades\Mail::raw('Testing Eamil', function ($message) {
        $message->to('foo@example.com');
    });
    return 'Success - Eamil is sent';
});

Vist yoursite.com/test
If Success - Eamil is sent is displayed in browser that means email is working fine. otherwise there is some error.
If there is any error, it will be displayed properly when debug mode is on.
Remove the code after test.

We support these payment providers.

Paypal

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

Please note that this support is for the Sandbox mode. Go to live mode !

Log in to your PayPal Business account.
Click Dashboard in menu.
Create an App by clicking Create App (Please check the official documentation)
In left menu, click Accounts to access your tests accounts
Click the Profile link under the BUSINESS type account
Click the API Credentials tab to get your credentials.
Copy and paste the API username, password, and signature into the /.env configuration file.
Open and edit .env file.
Provide your keys

PAYMENT_PROVIDER=paypal
PAYPAL_USERNAME=yourPayPalBusinessEamil@something.com
PAYPAL_PASSWORD=YourPassword
PAYPAL_SIGNATURE=YourSignatrue

[Screen shots]
paypal-sandbox-0-home paypal-sandbox-1-dashboard paypal-sandbox-2-accounts paypal-sandbox-3-access

You are done.
Visit Admin Panel -> Payment -> Packs to set packages and currencies
Clear Cache

Use Paypal in Live (in Production)

Make sure you have Business account before using paypal

Please follow these steps:

paypal-live-1-settings paypal-live-2-api-update paypal-live-3-view-username-password-signature paypal-live-4-view-api-signature

In this section we will configure Social API key for.

Facebook
Google
Twitter

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

You have to 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

Twitter Example in .env file

TWITTER_CLIENT_ID=your-twitter-client_id
TWITTER_CLIENT_SECRET=your-twitter-client_secret

Visit these pages to know how to configure them

Facebook
Google
Twitter

Create your Facebook App

Visit https://developers.facebook.com/apps
Click on Create new app

Select Website

Enter the App’s Name
Click on Create New Facebook App ID

Enter Contact Email and select a Category
Click on Create App ID

Enter Site URL
Click on Next

Go to the App Dashboard

Your can see your App ID
Now click Show to get you App Secret

Copy your App ID and App Secret
Login to your FTP account.
Open .env file
Paste your App Id and App Secret

Save and upload the .env file.
Make sure that you have provided your email and your app is in public mode.
You are done

Set your Facebook App

Now visit your App Settings page.
Provide your website name like example.com in App Domains field.
Click on Save Changes

Click Add Product (in left menu)
Then select Facebook Login by clicking Get Started

Turn Yes Client OAuth Login
Turn Yes Web OAuth Login
Provide Valid OAuth redirect URIs

Create a Facebook Test App for your main App

You need to create an Test App for your App when you go to live (or production)

Turn on Yes (on this step)
And select your Main App

After this step, you done and can use your Facebook App in live !

Now edit your LaraClassified /.env file

Login to your FTP account.
Open and edit .env file.
Add this code:

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

Replace your-facebook-client_id and your-facebook-client_secret.
Save and upload the file.
You are done.

Google OAuth Client ID

Edit your LaraClassified /.env file

Login to your FTP account.
Open and edit .env file.
Add this code:

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

Replace your-google-client_id and your-google-client_secret.
Save and upload the file.
You are done.

Google Maps Embed API

Edit your LaraClassified /.env file

Login to your FTP account.
Open and edit .env file.
Add this code:

GOOGLE_MAPS_API_KEY=your-googlemaps-key

Replace your-googlemaps-key.
Save and upload the file.
You are done.

Google Maps API Key

Before Using Twitter make sure you have configured your SMTP Settings

Visit https://apps.twitter.com ( Provide any details if it asks ).
Create new Create New App
Provide the Name, Description, and Website URL.
In callback URL provide http://yoursite.com/auth/twitter/callback
Click on Yes, I agree ( Read the terms )
Click on Create your Twitter application
New page will open.
Visit Keys and Access Tokens
Copy API Key and API Secret
Login to your FTP account.
Open and edit .env file
Provide the values in the file.

Example.

TWITTER_CLIENT_ID=your-twitter-client_id
TWITTER_CLIENT_SECRET=your-twitter-client_secret

Replace your-twitter-client_id and your-twitter-client_secret.
Save and upload the file.
You are done.

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.

Visit https://www.google.com/recaptcha/admin
Follow as given in below image

okHSW2N

Click Register
You will not get your site key and secret key

RLjgRLB

Login to your FTP account
Open .env file.
Provide the keys there.

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

Replace your-recaptcha-public_key and your-recaptcha-private_key.
Save the file.
You are done.

Image Setting

We support for two image processor.

GD
Imagick

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.

Visit here to know how to switch to Imagick

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

Login to your FTP account.
Open and edit .env file.

IMAGE_DRIVER=gd

Change it to

IMAGE_DRIVER=imagick

You are done.
Clear Cache (Optional)

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

Login to your FTP.
Visit storage/app/cache
Delete all file from it.
Visit your site in browser and refresh it.

For those who using cloud CDN

Login to cloud server
Visit cache folder
Delete all file from it.
Now login to your website FTP account
Visit storage/app/cache
Delete all file from it.
Visit your site in browser and refresh it for 10-15 times.

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.

LaraClassified Provides cloud CDN support

Visit amazon S3 console. ( Usually https://console.aws.amazon.com/s3/home?region=us-west-1 )
Create new bucket.
In permission settings add Everyone and select View Permission
Upload the uploads folder of laraclassified to your bucket.
Visit iam user settings in amazon. Settings Page
Select User from side bar.
Add new user.
Copy and paste your api key at some safe place.
Grant AmazonS3FullPermission permission to this user.
Now, login to you FTP account.
Provide the details in the .env file.
It will look something like this.

STORAGE_DRIVER=s3
S3_KEY=YourAmazonS3Key
S3_SECRET=YourAmazonS3Secret
S3_REGION=YourAmazonS3Region
S3_BUCKET=BucketName

If color pallet is not working fine then your need to set Access-Control-Allow-Origin Header in your amazon settings see here http://stackoverflow.com/a/19939041

Amazon CloudFront is a content delivery web service that works with amazon s3. Create a CloudFront account get a distribution url. After that.

Login to your FTP account.
Open and edit .env file.
Place this line to it.

S3_DISTRIBUTION_URL=YourDistributionUrlHere

Replace YourDistributionUrlHere with your URL.
Save and upload the file.
You are done.

Make sure to read the dropbox api terms and limits, before using it.

Visit public folder of you DropBox. Read here how to create public folderhttps://www.dropbox.com/enable_public_folder
Create a folder with name sellandbuy
Drag and drop the uploads folder to it.
Visit some file and click on share link, you will get your user id.
Visit https://www.dropbox.com/developers/apps
Click create new app.
Select Dropbox API app
Select No
Select All file types
Select some name and create new app.
Login to you FTP account
Open and edit .env file.
Provide the key value pairs as given below.

DROPBOX_CLIENT_IDENTIFIER=ClientIdentiferHere
DROPBOX_ACCESS_TOKEN=YourAccessToken
DROPBOX_USER_ID=YourUserID

Replace ClientIdentiferHere, YourAccessToken and YourUserID with your values.
Save and upload .env file.

Please note that color pallet will or will not work with dropbox. It don’t send image with Access-Control-Allow-Origin Header

We are not responsible if you void the copy terms and conditions

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

Login to you FTP account.
Open and edit .env file.

Change

APP_DEBUG=false

APP_DEBUG=true

Save and upload the file.

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

LaraClassified

Geo Classified Ads CMS

Install

Cloud Server Install

Shared Hosting Install

Subdomain Install

SMTP

What is SMTP ?

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

Own SMTP Server

Using your own or some SMTP server

Mandrill

Mandrill as SMTP

Amazon SES

Amazon SES as SMTP

Mailgun

Mailgun as SMTP

Mail Testing

Testing SMTP

Payment Providers

Paypal Sandbox

Paypal Live

Use Paypal in Live (in Production)

Social Keys

Facebook

Create your Facebook App

Set your Facebook App

Create a Facebook Test App for your main App

Google

Google OAuth Client ID

Google Maps Embed API

Google Maps API Key

Twitter API Key

Captcha

Recaptcha Key

What is recaptcha

How to setup.

Image Processing

Image Setting

Imagick

Clear Cache

Clear All Image Cache

For those who are not using cloud CDN

For those who using cloud CDN

Memory Settings

memory_limit

upload_max_filesize

Cloud CDN

Amazons S3

Amazon CloudFront

DropBox Pro

Debug Mode