Documentation
Servbook Web - Documentation
Introduction
- Created on: 3 January 2022
- Developed by: Dreams Technologies
- Support via email: [email protected]
- Support via Codecanyon: Take me there
-
Servbook Book your needed service and provider in one click! Easy Booking is compatible with simple, ideal solution.
Requirements
Server Requirements
Make sure your server meets the following requirements:
- PHP 7.4 or Above
- MySQL 5.6+
- Apache
Application areas
An XAMPP server can be installed and used with a single executable file quickly and easily, functioning as a local test system for Linux, Windows, and Mac OS X. The software packet contains the same components that are found on common web servers. Developers have the chance to test out their projects locally and to transfer them easily to productive systems. But XAMPP isn’t suitable to use as a public server, because many safety features have been deliberately left out to simplify and speed up the system for testing.
Installing XAMPP
Our XAMPP tutorial will take you through the installation process for the software package on Windows. If you’re using Linux or Mac OS X, then the steps listed below for the installation process may differ.
Step 1: Download
XAMPP is a release made available by the non-profit project Apache Friends. Versions with PHP 5.5, 5.6, or 7 are available for download on the Apache Friends Website.
Step 2: Run .exe file
Once the software bundle has been downloaded, you can start the installation by double clicking on the file with the endingexe.
Step 3: Deactivate any antivirus software
Since an active antivirus program can negatively affect the installation process, it’s recommended to temporarily pause any antivirus software until all XAMPP components have successfully been installed.
Before installing XAMPP, it is advisable to disable the anti-virus program temporarily
Step 4: Deactivate UAC
User Account Control (UAC) can interfere with the XAMPP installation because it limits writing access to the C: drive, so we recommend you deactivate this too for the duration of the installation process. To find out how to turn off your UAC, head to the Microsoft Windows support pages.
User account control can affect the installation of XAMPP
Step 5: Start the setup wizard
After you’ve opened the .exe file (after deactivating your antivirus program(s) and taken note of the User Account Control, the start screen of the XAMPP setup wizard should appear automatically. Click on ‘Next’ to configure the installation settings.
You can start the setup on the startup screen
Step 6: Choose software components
Under ‘Select Components’, you have the option to exclude individual components of the XAMPP software bundle from the installation. But for a full local test server, we recommend you install using the standard setup and all available components. After making your choice, click ‘Next’.
In the dialog window entitled 'select components', you can choose the software components before installation
Step 7: Choose the installation directory
In this next step, you have the chance to choose where you’d like the XAMPP software packet to be installed. If you opt for the standard setup, then a folder with the name XAMPP will be created under C:\ for you. After you’ve chosen a location, click ‘Next’.
For the next step, you need to select the directory where XAMPP should be installed
Step 8: Start the installation process
Once all the aforementioned preferences have been decided, click to start the installation. The setup wizard will unpack and install the selected components and save them to the designated directory. This process can take several minutes in total. You can follow the progress of this installation by keeping an eye on the green loading bar in the middle of the screen.
According to the default settings, the selected software components are unpacked and installed in the target folder
Step 9: Windows Firewall blocking
Your Firewall may interrupt the installation process to block the some components of the XAMPP. Use the corresponding check box to enable communication between the Apache server and your private network or work network. Remember that making your XAMPP server available for public networks isn’t recommended.
Step 10: Complete installation
Once all the components are unpacked and installed, you can close the setup wizard by clicking on ‘Finish’. Click to tick the corresponding check box and open the XAMPP Control Panel once the installation process is finished.
By clicking on 'finish', the XAMPP Setup Wizard is completed
The XAMPP Control Panel
Controls for the individual components of your test server can be reached through the XAMPP Control Panel. The clear user interfacelogs all actions and allows you to start or stop individual modules with a single. The XAMPP Control Panel also offers you various other buttons, including:
- Config: allows you to configure the XAMPP as well as the individual components
- Netstat: shows all running processes on the local computer
- Shell: opens a UNIX shell
- Explorer: opens the XAMPP folder in Windows Explorer
- Services: shows all services currently running in the background
- Help: offers links to user forums
- Quit: closes the XAMPP Control Panel
In the Control Panel, you can start and stop individual modules Starting modules
Individual modules can be started or stopped on the XAMPP Control Panel through the corresponding buttons under ‘Actions’. You can see which modules have been started because their names are highlighted green under the ‘Module’ title.
An active module is marked in green in the Control Panel
How to run PHP program in Xampp step-by-step?
- Write this program in a notepad and save it as file.php or any other name.
php echo " hello ashok"
- After completion of the installation, you can use the XAMPP Control Panel to start/ stop all servers.
- Start Mysql and Apache servers.
- Copy file.php to htdocs (C:/Program Files/XAMPP/htdocs)
- You can also create any folders inside htdocs folder and save our codes over there.
In order to get the dashboard for localhost: search http://localhost in any browser.
- Now to run your code, open localhost/file.php then it gets executed.
I hope you have understood about XAMP, the installation of XAMP and how to run a PHP program in Xampp.
Php Requirements
There are several PHP settings good to know to setup before you try upload any file.
memory_limit = 512M
upload_max_filesize = 128M
post_max_size = 128M
max_file_uploads = 50
max_execution_time = 3600
File Structure
File Structure - is the way you organize your folders and files on your computer. Keeping all your documents under one folder is a great way to keep organized and make things easy for backing up your computer.
├── serve_book/ │ ├── application / │ │ ├── config/ │ │ ├── controllers/ │ │ ├── core/ │ │ ├── helpers/ │ │ ├── language/ │ │ ├── libraries/ │ │ ├── migrations/ │ │ ├── models/ │ │ ├── views/ │ │ ├── .htaccess │ │ ├── index.html │ ├── assets / │ ├── engine/ │ ├── storage/ │ ├── uploads/ │ ├── vendor/ │ ├── .htaccess │ ├── index.php
Project Setup Guide
Step 1:
Go to xampp control panel:
Xampp control panle file path : C:\xampp\xampp-control.exe
To run this exe file,to start apache and Mysql
Step 2:
Unzip project source code to move to htdocs
(C:/Program Files/XAMPP/htdocs)
Ex: Assume project source code folder name: servbook.zip
Unzip and Move files to “C:\xampp\htdocs\servbook” this path
Step 3:
Import SQL file to phpmyadmin panel
Go to : http://localhost/phpmyadmin/
Step 4:
Create data base:
Click “database” menu, then enter new db name as “servbook”
Note: DB name must be same as above mentioned, otherwise issue thrown while run project.
Step 5:
Click “import” option to choose project SQL file
Go to: project source folder to find “servbook.sql”
Import completed:
After successfully import db in “phpmyadmin” section then go to browser
Step 6:
Run this url in browser:
Change DB and Server Path: (optional)
If you want to change DB name and Base URL follow below steps, otherwise skip this process,
Change Database configurations:
Ex: C:\xampp\htdocs\servbook\application\config\database.php
Code:
'hostname' => 'localhost', // Host name
'username' => 'root', //phpmyadmin user name
'password' => '', //phpmyadmin password
'database' => 'servbook', //DB name
Change Server configuration:
If you want to change server path, use this file to change
Ex: C:\xampp\htdocs\servbook\application\config\config.php
Code:
$config['base_url'] = 'http://localhost/New folder name/';
Google Calendar configuration:
If you want to enable google calendar, use this file to change
Ex: C:\xampp\htdocs\servbook\application\config\google.php
Code:
$config['google_sync_feature'] = TRUE;
$config['google_product_name'] = 'Servbook';
$config['google_client_id'] = 'xxxxx.apps.googleusercontent.com';
$config['google_client_secret'] = 'xxxxx';
$config['google_api_key'] ='xxxxx';
How to get Google API Credentials?
1.create new project on the Google Cloud Platform you will be able to see the main overview page (dashboard) that features plenty of information about your project and its API usage. Click on the “Go to APIs overview” button to redirect to the “APIs and Services” page.2.we have to activate the Google Calendar API Service so that the integration becomes available once you connect your calendar. (For this you will need to click the “Enable APIs And Services” button at the top, find Google Calendar in the displayed list and click on “Enable”. Afterwards you will need to create some credentials for your integration. You can do that by clicking the “Credentials” menu item on the left side of the page.)
3.next step is you will need two type of credentials, an API Key and an OAuth 2.0 Client. You will need to fill the consent screen information and then select Web Application in the next frame. Give it a client name and add your installation domain as the Authorised JavaScript origins (important give only the domain not the complete URL e.g. https://localhost).
4.The Authorized redirect URIs field will need the following value. http://localhost/New folder name/google/oauth_callback
5.Click on Create button and Google Cloud will show you two credentials (Client ID and Secret) that you need to mark for the following step.
6.Customers will be able to sync their appointments with Google Calendars so, you will need an API Key. Click again on the Create Credentials button while being in the Credentials overview page and select API Key.
Google Calendar Synchronization Steps
Step 1:
Need to add the Google synchronization details on application/config/google.php file. Refer to the screenshot.
Step 2:
To click the Enable Sync button to enable Google calendar synchronization.
Step 3:
If your Google sync keys are wrong. It's getting a Bad Request error message.
Step 4:
Once your synchronization is successfully enabled then you click the synchronize button to Sync the google calendar.
Fonts and Styles used:
- Fonts — Poppins and Nunito
- Styles — Go to /resources/assets/sass/style.css and here you can add style
Support
If you have any queries please contact us through email: [email protected]
Change LOG
VERSION 1.0 (03 January 2022)
- Initial release
Features
Landing page:
Front Service & Provider booking:
Admin login:
Click “Login” menu in header or go to
“http://localhost/servbook/user/login” this path
1. Login - Enter the username and password details for login.
Admin login:
Username : admin
Password: admin
Admin login:
2. Dashboard - After successful login, below details will be there in dashboard:
Admin Dashboard:
3. Appointment - View all appointment details in calendar day, week, and month view (Once Google calendar is enbled you will see "Enable Sync" & "Synchroniz" button)
4. Customer Create - For creating a new customer, Enter all the details.
5. Customer List - Once created a customer, we can check that all customers.
6. Add Category:
For creating a new Category, enter all the details.
7. Category List:
Once created a Category, we can check that all Category
8. Create service:
For creating a new service, enter all the details.
9. Service list:
Crated all service list shown here,
10. Provider list:
All service provider list shown this screen
11. Admin settings:
A. General settings:
B.Business Logic:
C. current user (admin)