# MotoVia Documentation

Complete installation & administration guide for MotoVia – Vehicle Sales Website / Multi-Dealer Directory

## Introduction

### MotoVia – Vehicle Sales Website / Multi-Dealer Directory

Welcome to the official documentation for MotoVia, a subscription-based vehicle sales website and multi-dealer directory.

##### About this guide

This guide covers the system requirements, the complete installation process and every part of the administration panel, so you can configure MotoVia for your business.

## About

MotoVia is a subscription-based vehicle sales website / multi-dealer directory.

Administrator here can sell monthly / yearly / lifetime pricing plans. If a dealer purchases a subscription plan, then they will be able to post vehicles on the website.

It also provides an e-commerce shop for administrator where administrator can sell physical / digital products. The shop has coupons, taxes, shipping fees, order management and order reports.

#### Subscription Plans

Sell monthly / yearly / lifetime pricing plans. Dealers can post vehicles after purchasing a plan.

#### E-Commerce Shop

Build-in shop for physical / digital products with coupons, taxes, shipping fees and order management.

#### Payment Gateways

3 automated online payment gateways, unlimited offline payment gateways and currency settings.

#### Multilingual & RTL

3 unique, attractive and modern templates. Fully multilingual frontend with RTL support.

Additionally it provides management system for — PWA, advertisements, dealers, payment logs, support tickets, sellers, users, popup notifications, custom pages, blog, FAQ, languages, admin / roles permissions, drag & drop menu builder, Colors, SEO information, Maintenance Mode, Cookie Alert, SMTP Settings, Email Templates etc…

## Installation

This item is built on Laravel Framework (Version – 9.52.15).

### Server Requirements

- PHP 8.2 – 8.3
- BCMath PHP Extension
- Ctype PHP Extension
- Fileinfo PHP Extension
- JSON PHP Extension
- Mbstring PHP Extension
- OpenSSL PHP Extension
- PDO PHP Extension
- Tokenizer PHP Extension
- XML PHP Extension
- GMP PHP Extension
- EXIF PHP Extension

### Installation Steps

#### Getting the installation file

After purchasing MotoVia you will get a ZIP file. After extracting the ZIP file you will get the installation file installable.zip.

#### Uploading the installation file

Upload installable.zip to your server and extract it.

After extraction is complete, delete the installable.zip file from the server.

- In the root, open the `.env` file and fill in the database credentials.
- If you upload it to the public_html folder, then visit `your_domain.com/install` in your browser.
- If you upload it to a folder inside the public_html folder, then visit `your_domain.com/folder_name/install` in your browser.
- If you upload it to your created subdomain folder, then visit `subdomain.your_domain.com/install` in your browser.
- If you upload it to a folder inside your created subdomain folder, then visit `subdomain.your_domain.com/folder_name/install` in your browser.

#### Welcome page

After entering your website URL in the browser, you will see the MotoVia Installer welcome page. Then click the Check Requirements button.

#### Server requirements

Next you will see a list of extensions required to run this software. If all extensions have green check icons, then click the Check Permissions button. If any extension has a red cross icon, then you must enable/install the extension on your server. You may need to contact hosting support.

#### Folder permissions

In this step you will see a list of folder locations and their required permissions. If all folders have green check icons. If any folder has a red exclamation icon (like in the image above), then you must first change the folder permission.

Let us show you how to change folder permission of 'storage/framework/' as an example:

- Go to the storage folder (located in the root folder) on your server
- Right-click on the framework folder and select Change Permissions from the dropdown menu
- Then you will see a popup window, change the permission to 775 in the popup window
- That's it, you have changed the permission to 775 for 'storage/framework/'. Now repeat the same procedures for other folders from the list shown in the Permission Step in the MotoVia Installation Wizard
- Then enter all your database information — Database Host, Database Name, Database User, Database Password

#### Change Permissions

Right-click the framework folder and select Change Permissions.

#### Set permission to 775

Change the folder permission to 775 in the popup window.

#### Database setup

In this step you have to enter some information about your environment and database.

- Application Name: Enter your application name
- Application Debug:
  Enabled – If you want to see error messages when an error occurs on the website & Disabled – if you don't want to display error messages. We recommend you keep it disabled as database credentials will also be displayed if you keep it enabled
- Application URL: Enter your website URL.
- Then enter all your database information — Database Host, Database Name, Database User, Database Password

After entering all information, click the Install button.

#### Installation success

In this step you will see the installation success message. Then click the Click here to finish button at the end of this page and you will be redirected to the installed website.

#### Delete installation directory

Now you can delete the installation directory located in the public directory.

##### After installation

Always delete the installable.zip file and the installation directory from your server, and change the default administrator credentials immediately after the first login.

## Administrator Login

You can manage everything from this admin panel, such as email settings, content, pages, offers, reservations, payment gateways, roles / permissions, customers, website color etc…

### Default Credentials

    # Admin URL
    your_domain.com/admin
    # Username
    admin
    # Password
    admin

##### Security

Change the default username and password immediately after the first login.

## Administrator Profile

Administrator can change username and some details here (screenshot):

## Website Color

Admin can change the base color of the website and breadcrumb overlay color from 'Basic Settings > General Settings' Admin Panel:

## Custom Pages

Admin can create pages from 'Custom Pages > Add Page'

## Drag & Drop Menu Builder

Admin can edit the website menu from 'Drag & Drop Menu Builder' Admin Panel.

There are some pre-made menus (like – home page, blog, rooms, packages etc…) that can be added to the website menu by simply clicking the Add to Menu button.

Admin will find custom pages at the end of pre-made menus and can add them to the website menu by clicking Add to Menu.

Admin can also create additional menus with URL or without URL.

Admin can edit menus (name, URL [not used for pre-made menus], target attribute).

## Email Settings

### Admin Email

Admin can set up SMTP for email settings. All emails to customers will be sent from this email through this website.
Admin can set SMTP details in Basic Settings > Email Settings > Admin Email.

Some important notes regarding SMTP:

- Sometimes SSL encryption has some issues on some servers because PHP is now very strict about SSL checking. In that case, please choose TLS.
- If you choose TLS, don't forget to change the SMTP port accordingly (in most cases it's 587, however it may be different on your server).
- If you choose SSL, don't forget to change the SMTP port accordingly (in most cases it's 465, however it may be different on your server).
- If you still have problems, please contact your hosting support and show them the SMTP details you are using in the SMTP form in the admin panel. This mostly depends on the server, so SMTP problems can only be resolved with hosting support.

### Email Templates

Admin can set email structure and content from 'Basic Settings > Email Settings > Email Templates' Admin Panel.
MotoVia provides several email templates that can be edited by clicking the Edit button for each template.

In the template edit form, admin can set email content and use Text Editor tools to edit content. Additionally, admin can use {shortcode} to display some important dynamic data.

## Currency Settings

Admin can set currency in Basic Settings > General Settings.

Admin must set currency rate based on USD.

## Payment Gateway Settings

### Online Gateways

All online payment gateways can be configured in Payment Gateways > Online Gateways.

Admin can also configure payment gateways in test / live mode.

### Offline Gateways

Admin can create offline payment gateways to receive payments for reservations.

Admin can set instructions and description (optional) that will be displayed to customers on the payment details page.

Admin can also enable / disable attachment status.

- If attachment is enabled, customer will have to upload their transaction image during payment.
- If attachment is disabled, attachment field will not be shown to customers during payment.

## Language Management

Admin can create unlimited languages and translate the website for this language from Language Management admin panel.

After adding a language, admin must click the Edit Keywords button for this language to translate all website keywords into this language.

Admin can also change English language keywords.

## Popup Announcements

MotoVia provides 7 types of popups during popup creation.

Admin can also activate / deactivate any popup.

Multiple popups can be displayed on the website. Popups will be visible according to serial number (set by admin).

## Maintenance Mode

Admin can set the website to maintenance mode from Basic Settings > Maintenance Mode.

In maintenance mode, admin can always access the admin panel.

Admin can set a secret string (avoid using special characters, use a combination of letters and numbers) to access the website.

##### Access via secret string

Anyone who knows the secret string can access the website by entering `{website_url}/{secret_string}` in the browser.

## Administrator / Roles and Permissions

Owner can create roles from Administrator Management > Roles and Permissions & can assign permissions by clicking the Edit button for that role.

## Plugins

Plugins: Here admin can integrate some third-party tools with MotoVia. Admin can also hide/show these widgets.

- Disqus(Required for blog comments) — https://disqus.com
- Facebook Login— https://developers.facebook.com
- Google Login— https://console.cloud.google.com
- Google Recaptcha— https://www.google.com