Hungry Duck

GLOBAL AUCTION SYSTEM Admin Seller Bidder Bidding


Thank you for purchasing my Project. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!

It is a bidding system, which fulfils the needs of user, can perform bidding on items and win easily.

Auction bidding implemented using socket.io

Cpanel

Easy Installation Process : Localhost
Set up Global Auction System through the following steps:
  • Unzip and copy the script folder in your localhost.
  • Run the script path from any web browser. Ex : http://localhost/project_folder_name/install.
  • Provide database settings.
  • Run the installer.

hosting

please_wait

success

Create User account for the first time

create_user

Note: If database already exists, please edit the .env file which is at project_folder/.env

Update the following information in .env file

DB_HOST=localhost(default)

DB_PORT=3306(default)

DB_DATABASE=Your database name

DB_USERNAME=Database Username

DB_PASSWORD=Password

1.Cpanel Login

Cpanel

2.Go to File Manager

File Manager

3.Click on public_html folder

public_html

4.Upload the Project zip folder into public_html folder
5.Extract the zip folder here
6.Create the Database using MySQL Wizard

public_html

Create Database

database

7.Note down DB Name,DB Password, DB Username
Type URL www.yourserverdomain/install and follow Installation Steps

Manual Installation

Note: If you are installing the system manually, please do install the database with data as it has default admin user with credentials admin@admin.com and password

8.Go to phpmyadmin (check whether database created or not ?)

database

9.If Database created upload the database file which is available in Project Folder/public/downloads/database/install_dummy_data.sql and click on Go

database

10.Edit the .env file in project folder and update with new Database credentials(which already created).

env

Still you’re facing Issues in Configuration Please Contact Us:

Facebook App Setup

This document provides instructions on how to properly setup a Facebook application so that users can login/register via Facebook on your site.

Creating a new app
  1. To allow users to login to your site with their Facebook account you need to create a Facebook app. To create a new Facebook app please do the following:
  2. Go to the Facebook Developers site:https://developers.facebook.com/
  3. If you are not logged in, login to the site using your Facebook account details
  4. Once logged in, click on Create App button. Fill out the Display Name, Contact Email and choose a category for your app. Then click the Create App button.

fb_app_id

Note: After clicking this button you may be presented with a security check

Select "Set Up" for "Facebook Login"

select_product

Select "Web Option"

web_option

Set your "Site URL"

site_url

Skip all others step of the process.

steps

Settings Tab ➔Basic

basic_settings

Settings Tab ➔Advanced

App Restrictions - You can restrict your app to specific age range and countries if your site references alcohol or an adult nature site.

advanced_settings

Products Tab

1.On the Products tab, click on +Add Product then click Get Started button on Facebook Login

product_setup

2.After you clicked the Get Started button, click on Settings under Facebook Login

Client OAuth Settings

You just need to enter your site's login, register and account's social tab URIs into the Valid OAuth redirects URIs field.

oauth_settings

You can just leave the Deauthorize Callback URL blank then click on save changes.

App Review Tab

Once you have done all these steps you can go to the App Review tab to make the app live. The app does not need to be submitted for approval as the app will only be requesting the standard data from users. To make the app live all you need to do is click the switch button from No to Yes:

app_public

App Setup Complete

Once you have done all that, the app is now complete. You should now add the App ID and App Secret into the Site Settings→ Social Logins if you have not already done so.

Google + App Setup

This document provides instructions on how to properly setup a Google+ application so that users can login/register via Google on your site.

Enabling API

To allow users to login to your site with their Google+ account you need to create a Google+ project and enable Google+ API. To enable API and create new Google+ project please do the following:

enable api

Go to Social APIs - Google+ API

google plus

Enable Google + API

enable google plus api

Creating new project and adding credentials

Enter the project details in the pop-up that appears and click the “create” button

enable google plus api

Go to Credentials sidebar and add credentials OAuth Client ID

google credentials

Which API are you using - Google+ API

Where you will be calling the API from - Web Browser

google credentials

Create client ID

google credentials

Credentials

google credentials

After the client ID is created you will see some information appear on the page

Copy and paste the Client ID and Client Secret into the Google+ tab on the Settings>Site Settings > Social Login page to connect your site to your App.

Note: Social Logins only for Bidder Accounts.

Overview

Global Auction System is a project which is developed in Laravel and MySQL with the aim to develop an Online auction system where administrator/sellers of the site can login and add auction items, so that user can search and view details of auction items with images, address and auction date / time and then can bid or purchase auction items.

Home

Seller/Bidder can Register through web (social logins facebook, google plus only for bidder )

Login


Three types of Users are there

Admin : Full control of System
Seller : Sell an Auction
Bidder : Bid or Buy an Auction

Admin have all the rights of Global Auction System.

Admin can update his account details.
Admin can change his account password.
Admin can view summary of all modules in his dashboard.
Admin can set cron job in his server like shown in below screenshot (cron job is for update auction status as closed automatically when auction end date time crosses).
Admin get notifications when users registered into site.
Admin get notifications when few actions occur like seller create an auction, seller update an auction, bidder paid bid amount or bidder purchase an auction item etc..

With this module, admin can control all the users of the site

Admin can add,update,activate/de-activate a user

Admin can add,update,delete FAQ category

Admin can add,update,delete FAQ under particular category

Which are active FAQs, reflects in front end, which clarifies user queries.

Admin can add,update,delete auction category.

Admin can add,update,delete sub category under particular auction category.

Categories, sub categories reflects in auctions module at the time of creating an auction.

Categories, sub categories reflects front end in Home page menu and in Auctions page

Admin can add,update country / state / city.

Locations reflects at the time of creating user.

Locations reflects front end in Auctions page

This module helps you to make your site multilingual

Here we provided flexibility for user to change the site language as per the requirement

In this, you can create, edit or delete the languages

At any point of time you can set any one language as the default language.

Support RTL languages also

Features

This module helps admin to convey site information to users.
Which reflects in front end site footer as USEFUL LINKS.

With this module admin can control the total site based on the requirement.

These settings are loaded to the site as Lazy Loading to improve the performance of the site i.e., load the settings what it requires instead of loading all settings at a time. We made it to hit the database as less as possible for getting the settings

It supports the settings for the following modules

Site Settings

Contains the settings for the site like title,logo,favicon,address,contact number,contact email,date formats etc..

For API key for Google Map Refer

Modules Management

This module gives flexibility to enable or disable few modules available in this system.

Stripe Settings

Contains the settings of stripe payment gateway

Auction Settings

Contains few settings related to auctions like
Admin commission type - free or fixed or per auction ,
If admin set it as free - then seller need not to pay commission for his auctions
If admin set it as fixed - then seller need to pay commission value only once for all of his auctions
If admin set it as per auction - then seller need to pay commission value for each of his auction.

Note: currently no online mechanism implemented for seller for payment,
seller can pay either manually or admin can take his commission value from bidders amount (i.e. bidders pay bid amount or buy now amount of auction through online which get transferred to admin who is maintaining the site )

Enable featured items - Yes or No
If set it as Yes - then front end Featured Items will be shown (i.e. in home page - Bid Products - FEATURED tab, in Auctions page - Featured filter),
else if set it as No - then front end Featured Items will not be shown.

Active picture gallary - Yes or No
If set it as Yes - then front end auction details page auction picture gallary will be shown,
else if set it as No - then front end auction details page auction picture gallary will not be shown.

Max number of pictures
Set the number of pictures can be shown in auction picture gallary in front end auction details page.

Update auction status cron job - Yes or No
It will update the auction status as closed automatically, when auction end datetime crosses through cron job.

Cron jobs run
Set the cron job run time like every 5 mins or an hour etc..

Note: Please go through the reference how to set cron job in your server

Email Settings

This modules provides 8 mail drivers for sending emails. The supported drivers are: SMTP, Mail, Sendmail, Mailgun, Mandrill, SES, Sparkpost, Log

Mail Driver: Select any of the mail drivers from the available list

Mail Host: Update your hosting server

Mail Port: Port number

Mail Username: Admin/user email for sending emails

Mail Password: Email Password

Mail Encryption: default set to null

Social Logins

Contains the settings for the social logins facebook, google plus

SEO Settings

Contains the seo settings which helps your website traffic.

Paypal Settings

Contains the settings of paypal payment gateway

Social Networks

Admin can set his site social networks, which reflects in front end, so that users can follow and get updates regarding site.

SMS Settings

Providing three SMS drivers - NEXMO, PLIVO, TWILIO.
Admin can set SMS settings and send SMS to users.

PayU Settings

Contains the settings of payu payment gateway

Admin can add,update,delete testimonials, which reflects in front end.

Admin can edit the email templates as per requirement.

We have divided template into 3 parts
1.Header
2.Content
3.Footer

Here the header and footer are common templates for all the email templates. Change at one place and it will be updated in all other templates.
You can edit the content part as per your requirement in each template.

Admin can view,add,edit auctions.

Auctions module is common for Admin and Seller, Admin has more rights (like auction status, admin status) than seller.

Admin/Seller can create an Auction.

Explanation of each field of auctions module.

Auction Title ,
Seller - if admin creating an auction - select seller from available sellers in site i.e. this auction belongs to which seller , else if seller creating an auction - by default it will consider that this auction belong to respective seller who is creating ,
Category, Sub Category - select from available list i.e. this auction comes under which category and sub category
Start Date, End Date - start datetime and end datetime of auction
Live Auction Date, Live Auction Start Time, Live Auction End Time - Users can perform live bidding during this time
Reserve Price - this is the price if bidder bid amount reaches or exceeds the reserve price then respective bidder is the winner of this auction
Minimum Bid - this is the price if bidder would like to place bid amount for an auction which should be higher than this minimum bid
Is It Bid Increment - Yes or No
If set as Yes - bid amount of bidder should follow incremental process, If set as No - then bidder no need to follow incremental process , can place any amount in bidding which is higher than previous bid amount
Bid Increment - If not set any price - then bidder need not to follow incremental process, If set some price like 200 - then bidder should follow incremental process like 6400, 6600 etc.
Is It Buy Now Item - Yes or No, If this auction item can be sell directly then you can set as Yes else No
Buy Now Price, If it is sellable item, then you can set Buy Now price, so that if any bidder is interested to buy he can pay amount (buy now price) through online available payment gateways
Description Can describe auction information in detail, which helpful for bidders
International Shipping - Yes or No, If you have international shipping facility set it as Yes else No
Payment and Shipping Can describe regarding payment and shipping, which helpful for bidders
Terms Can describe regarding terms of an auction, which helpful for bidders
Is Featured - Yes or No, If it is featured item set it as Yes else No
Auction Status - New, Open, Suspended, Closed
New (Upcoming) - If the auction is upcoming auction,
Open (Live) - If the auction is live now,
Suspended - can suspend auction, which do not reflect in front end,
Closed (Past) - If the auction is already sold or bidding is over
Admin Status - Pending, Approved, Rejected
Approved auctions - reflects in front end
Only Admin can change Auction Status and Admin Status
Auction Image - Upload auction main image

Auction Notifications

Admin or Seller can view an auction.

View page - divided into 3 parts
1.Auction Details
2.Images
3.Auction Bidders

Auction Details tab - showing all the details of an auction

Images tab - Admin or Seller can upload auction images here, which reflects in front end auction details page (latest images)
The number of images reflects in auction details page can be set in Auction Settings - Max Number of Pictures

Auction Bidders tab - in this tab showing all the bidders and their bidding history
If an Auction reaches Reserve Price then Admin can close the auction (update auction status as Closed)
Then Admin can send Invoice to Bidder regarding bid payment
If Admin send Invoice to first highest bidder, if this bidder do not pay till mentioned date, then Admin can send Invoice to second highest bidder etc..

Admin can send email regarding any updates or information to users who are subscribed to this site (in front end footer)

Admin can view reports
1.Seller wise (graph format)
2.Year-Month wise (graph format)
3.Seller auctions

Admin can view all his notifications

Admin can send SMS to Sellers or Bidders

This is Internal Messaging System through which Admin can send message to any seller or bidder

Admin can view all payments history and complete details here

Seller can update his account details.
Seller can change his account password.
Seller can view summary of modules in his dashboard.
Seller get notifications when admin create/update an auction which belong to him

Seller Auctions module - same as Admin Auctions module

Seller can view all his notifications

This is Internal Messaging System through which Seller can send message to Admin

Auctions - showing 3 types
1. Regular/Normal - If Admin status is Approved, Auction status is Open, Todays date between Auction Start Datetime and End Datetime,
2. Upcoming - If Admin status is Approved, Auction status is New, Todays date between Auction Start Datetime and End Datetime,
3. Past - If Admin status is Approved, Auction status is Closed

Home page every thing is dynamic data, whatever admin set in his panel will reflects here.
Sliders, text, logo, Categories etc..

Home page - Latest Auction Deals - The Auctions which are Regular/Normal can be shown here.

Home page - Bid Products -
1. ON SALE - Auctions which can be sale (Live and Buy Now Item)
2. LATEST - Admin status is Approved, Auction status is Open or New, Todays date between Auction Start datetime and End datetime
3. PAST - Admin status is Approved, Auction status is Closed
4. FEATURED - Admin status is Approved, Auction status is Open or New, Todays date between Auction Start datetime and End datetime

Home page - Live Auctions -
Admin status is Approved, Auction status is Open, Auction date is todays date.

Home page - Words From Our Clients -
These are Testimonials which admin create in his panel.

Home page - Footer

User can view all the Auctions available in site

Item type All Items, Auctions, Buy Now
All Items - Products which can be auctioned or bought
Auctions - Products which can be auctioned only (regular/normal auction OR live bidding)
Buy Now - Products which can be bought only

Auction Status Regular/Normal, Upcoming, Past
Regular/Normal - Todays date between Auction start date and end date, Auction status is open , Admin status is approved
Upcoming - Todays date between Auction start date and end date, Auction status is new , Admin status is approved
Past - Todays date is greater than Auction start date and end date, Auction is over

User can view complete auction details in this page

Bidder can view summary of modules in his dashboard.
Bidder get notifications when admin send invoice etc..

Bidder can update his profile details
Bidder can update his billing,shipping address details
Bidder can change his account password

Bidder can view all his favourite auctions

Bidder can view all the auctions which he participated

When Admin send Invoice to bidder regarding payment - Pay button enable here, so that bidder can pay bid amount through available payment gateways

Bidder can view bidding history

Bidder can view the auctions which he bought

Bidder can view all his payment history

Bidder can view all his notifications

This is Internal Messaging System through which Bidder can send message to Admin

User can view all live auctions which are happening today.
Admin/Seller - Auctions module
Set Live Auction Date = todays date, start time, end time
When Live Auction takes place, Regular/Normal Auction can not be performed.

Incremental price 700 set to auction
User X

User Y

Users can not place bid,If bidding time is over.

If any user reached Reserve price, Bidding time is still not yet over, then users can continue place bid until unless bidding time is over

Note : Few servers supports socket.io like Amazon Web Services, Heroku, Cloudflare