myOwnReservation

myOwnReservation
Rent your products with simplicity
User manual
myOwnReservations
Rent your products with simplicity
User manual
Summary
INSTALLATION
3
UPLOAD MODULE
CHECK BEFORE SETUP
MODULE INSTALLATION
3
3
4
ON THE FRONT OFFICE
5
ON PRODUCT PAGE
CART
ORDER
5
6
7
RESERVATION SYSTEM
8
RESERVATION WINDOW
RESERVATION DURATION
PRICE OF BOOKING
8
9
9
SETTINGS
10
GENERAL SETTINGS
RESERVATION SETTINGS
RATES SETTINGS
ADVANCED SETTINGS
10
11
14
16
ADMINISTRATION
17
MONTH RESERVATION VIEW
WEEK RESERVATION VIEW
DAY RESERVATIONS VIEW
17
18
18
Page 2 on 20
myOwnReservations
User manual
Rent your products with simplicity
Installation
Upload module
Upload with FTP protocol
Unzip the module and drop the folder « myOwnReservations » in the folder /modules/ on the
Pretashop folder on your web server.
Send via the modules management interface!
Go to the modules section of the admin panel of Prestashop.
1
2
2 Click on the link “Add a new module”, the panel below appears.
1 Select the module zip file by clicking on “Choose File” then click “Load Module” and wait for
sending the file.
Check before setup
To run properly some files need to be copied to “override” folder of Prestashop. For that, write
rights must be added for “everybody” on that folder with your FTP client or by taping the following
command by SSH from the Prestashop folder : chmod 777 override
Without this manipulation the following message would appear during setup :
Page 3 on 20
myOwnReservations
Rent your products with simplicity
Module installation
Once sent the module appears in the list of modules. Just click on the Install button.
Page 4 on 20
User manual
myOwnReservations
User manual
Rent your products with simplicity
On the front office
On product page
The reservation panel is displayed on the product page. Only if the product category matches the
one you choose in the configuration.
1 The price is no more indicated
for the product purchase but for the
reservation for a day or for a time
slot.
The “Add to cart” button is
replaced by “select a period” that
displays the reservation panel at the
end of page.
1
Quantity or attributes modification
(in our case color) leads a refresh of
reservation panel for check of
reservation capabilities with
attributes and quantity chosen.
2 The reservation panel shows
capabilities for reservation begin for
the week and for the attributes and
quantity chosen.
Select inputs allow the selection of a
reservation start time slot. Two
buttons in the bottom of the panel
allow the switch of displayed week.
2
“Validate start” button let validate
the start reservation choice to go to
the end of reservation choice.
A
B
C
D
Caption
A Time slot available: the time slot is available to reservation by taking into account reservations
already made.
B Holiday: This day has been added as holiday in the module configuration.
C Unavailable time slot: All products have been reserved on this time slot, so it is not allowed for
selection.
D Disabled time slot: This day of the week the time slot in not enabled.
Page 5 on 20
myOwnReservations
Rent your products with simplicity
User manual
End of reservation selection
After the selection of the reservation
start, the reservation panel appears
again to offer a date and a end time
slot.
1 The start date and time slots are
displayed. A button “Change” let
change this selection.
2 The panel now displays the
reservation capabilities on the length
by taking into account reservations
already made.
Each time slot shows the reservation
price according to the number of
products and the reservation length. In
the example displayed the price
depends on the number of days but it also possible to make it to depend on number of time slots.
If the max length of reservation allow it, it’s possible to switch to the next week.
The “Add to cart” button adds the reservation to the cart.
Cart
Once added to cart the reservation is visible in cart widget under the product
concerned and it potential attribute.
Multiple reservations with different dates can be done on the same product
(with same attributes), in this case all reservations are displayed under the
product.
Product and all reservations associated can be deleted by clicking the trash icon
on the right of the product name.
The presentation is the same on the order
summary.
Because of reservation process and
checking associated, the quantity selection
is not enabled.
Page 6 on 20
1
2
myOwnReservations
Rent your products with simplicity
Order
Order confirmation
The order confirmation email displays the
same details as the cart.
The reservation details of each reservation
are displayed in the line of corresponding
product under the name and the attribute of
this one.
Order history
In the order history page, the order details
also shows the details of the reservation for
each products.
Products associated with reservations are
separated from the rest of the products of
the order and are highlighted with
reservation dates.
On the last line the reservation status is
displayed. By default the reservation is on
validation pending until payment has not been
done.
Page 7 on 20
User manual
myOwnReservations
User manual
Rent your products with simplicity
Reservation system
Reservation window
The booking window is all the weeks which a reservation is possible. Defined by:
•
•
•
The day and start time of the booking period,
The reservation shift that defines the number of weeks to wait to make a reservation
The reservation period that defines the number of weeks during which it is possible to make a
reservation
Reservation windows samples
mon tue wed thu
fri
sat sun
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
mon tue wed thu
fri
sat sun
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
mon tue wed thu
fri
sat sun
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
In the example displayed, the reservation windows is defined
by :
Reservation period : 7 days
Reservation start : The next week
week start :
Monday 00H00
The days available begins on Monday of the next week.
In the example displayed, the reservation windows is defined
by :
Reservation period : 12 days
Reservation start : The same day
The days available begins the current day for 12 days.
In the example displayed, the reservation windows is defined
by :
Reservation period :
Reservation start :
number of days :
12 days
After some days
1 day
The days available begins the next day for 12 days.
Reservation validation
The reservation is attached to the user control if it exists. By default the booking is confirmed when
the order goes to state awaiting payment. The calculation of the occupation of slot is made according
to the validated orders.
It is possible to choose the order status to validate the reservation.Example: Payment accepted.
Page 8 on 20
myOwnReservations
Rent your products with simplicity
User manual
Reservation duration
The duration of a reservation can be calculated in two ways:
•
•
Number of days between the start date (included) and end date (included).
Number of slots between the start time slot (included) and the end time slot (included).
We'll see how the term is used for reservation dates and price calculation.
Min and max duration of reservation
Do not confuse the reservation period and the duration of reservation, the reservation period
defines the interval of time that reservations are possible, the duration of reservation is contained in
this interval but the customer who chooses it.
You can choose the range of possible value for this time length through the parameters min and max
length. You can choose to set this option with day or time slot unit with no impact on the calculation
of the price. In all cases the interval must be less than the reservation period. You can choose a value
equal min and max, in which case the user cannot choose the duration of the reservation, and if the
minimum and maximum duration is one time slot then the customer will directly see the price of the
reservation.
Holidays and disabled time slots
Reservations cannot begin or end during a holiday, or a disabled slot, however you can choose
whether the reservation can run for such days or time slots.
If you ban the reservation to run on holidays, then the reservation will be completed no later than
the last time slot before the holiday. If the minimum duration of a reservation is greater than 1 then
the book just before the holiday will not be permitted.
A second option offers the same mechanism but for disabled time slots (for a day setting, every time
slots of the day must be disabled).
Price of booking
The price of the book is based on the product price multiplied by the duration of the reservation.
You can choose to set this option in a day or time slot.
There are also two options for the consideration of leave and disabled slots in the price. (For setting
all day slots of the day should be disabled).
Page 9 on 20
myOwnReservations
Rent your products with simplicity
User manual
Settings
General settings
Choose the category of products on which reservation system would be applied. You can choose
"All" to apply reservation on all products. If you want, you can create a specific category that is not
visible for these products. You can choose "All" to apply reservation on all products. If you want, you
can create a specific category for these products that is not visible.
At right of the bottom band, an icon let you know if the module is up to date. Click on that icon to
show the history of module versions.
Page 10 on 20
myOwnReservations
Rent your products with simplicity
User manual
Reservation settings
Time slot management
The time slot is a period during which a customer can reserve a product. You can create as many
time slots that you want but the end time or start time of a time slot cannot be included between the
start time and the end time of another time slot.
Reservation properties
Reservation+start+
This option allows you to choose when the reservation start. Select "the current day" so that
reservation can be made the day of order, in which case you must specify whether the reservations
can be made during the current slot, otherwise the reservations will only be possible on the next
time slot.
•
•
•
Select "After a few days" so that reservations can be made one or more days after the date of
the order, in this case you need to specify the number of days in period (1 for next day, 2 for
on-day etc. ..).
Select "next week" so that reservations are only possible one week to the next (if the current
week is started, the booking will only be possible from the beginning of the following week).
In this case you can change the day and time of the start of the week.
Select "After a few weeks" so that reservations can be made a week or more after the date of
the order, in this case you must specify the number of weeks of delay.
Page 11 on 20
myOwnReservations
Rent your products with simplicity
User manual
Reservation+period+
This option let you chose the reservation period in days. For instance if the reservation start is set to
1 day after and the reservation period is set to 2, the customer can select a reservation during the
two next days. If this parameter is set to 0, the reservations are available until the end of start day.
Reservation+unit+
Select the time unit of your reservations, this parameter is important because it will define is the
price of the product has to be use for a time slot period or a day period. This parameter also defines
the unit of the reservation lengths parameter underneath.
Reservation+min+length+
Set the minimal period of a reservation here, if you set 1 the customer can select one time slot or
day (depending on the unit utmost) or more until the max reservation length.
Reservation+max+length+
Set the maximal period of a reservation here, if parameter needs to be greater or equal to the
minimal reservation length. If you set 1 the customer would be enable to select only one time slot or
day (depending on the unit utmost). You can choose the value you want (upper that 0) but the length
of the reservation will be limited in the reservation period window.
Holiday period
On a holiday period reservation start and stop cannot be done.
Indicates holiday start and end by clicking on the input. The start and end date are included into the
holidays. For a day only indicate the same start date and end date.
Holiday+rule+
Check this box to disable reservation that run over holidays, so the reservation that begin before the
holiday would end at last before this holiday.
Page 12 on 20
myOwnReservations
Rent your products with simplicity
Time slots edit
To configure a time slot you must set :
•
A name : cannot be empty and must be smaller
than 10 chars. The name is show when a customer
selects a time slot.
•
A start time and end time : A start time and a end
time of the time slot cannot be included between
the start time (excluded) and the end time
(included) of another time slot.
•
The days : Check the days for which time slot
would be available in each week.
Page 13 on 20
User manual
myOwnReservations
Rent your products with simplicity
User manual
Rates settings
Prices rules management
The prices rules let you customize the price calculation of a reservation by applying a discount that
can be a percent of the price or an amount. You can choose different types of rules :
•
•
•
Length : let you apply discount depending on the length of the reservation;
Dates : let you apply a discount on a period between two dates;
Recurring : let you apply discount on a certain time slot, on all or some days of the week. You
can enable or disable theses rules at any moment.
Prices properties
Product+prices+
This parameter is very important, it is use to calculate the reservation price. The reservation price is
based on product price multiplied by the length of the reservation, you can set here if the length is
the number of time slots or the number of days between reservation start and end.
Disabled+rule+
The reservation length (that is used to calculate the price) is the number of time slots or days
between reservation start and end. You can check this box to count disabled time slots in
reservation length if previous parameter is set to "time slots"; or to count days without enabled time
slot in reservation length if previous parameter is set to "days".
Discount+
If a discount applies, this option can highlight the discount by bolding the price of the time slot and by
painting it in red.
Page 14 on 20
myOwnReservations
Rent your products with simplicity
User manual
Price rule
To configure a price rule you must set :
•
•
•
•
Product : This parameter let you choose the impact of your discount, you can choose a
particular product otherwise it will be applied to ail the products from the product category
of general parameters.
Ratio : The ratio give the discount amount as a
part of original product price. For instance if you
fill 10% and the product cost 150, the discount
would be 15.
Amount : The amount give directly the discount
value and it can be cumulate with the ratio.
Enabled : You can enable or disable the price rule
without deleting it. If the price rule is disabled it
will not be applied on reservation price calculation.
Length+
For a length rule you've to choose the minimum and
maximal length between which the discount apply. The
min length as to be less or equal than the max length. You
can set both length to 0 to apply the discount on any
length. The impact let you choose if the discount apply
only on the reservation part, which is between min and
max, or on all the reservation.
Dates+
For a dates rule you've to choose the start and end date
between which the discount apply. The impact let you
choose if the discount apply only on the reservation part
which is between start and end date or on all the
reservation.
Time+slot+
For a recurring rule you can choose all time slots or a
specific time slot and all days or a some days of the week
for which the discount apply.
Page 15 on 20
myOwnReservations
Rent your products with simplicity
User manual
Advanced settings
Reservation+status+
This option let you chose on which step of the order the time slot is reserved. You should choose
between “Awaiting cheque payment” or “Payment accepted” (“Awaiting cheque payment” works also
for other payment modules). The statuses lower than the selected status invalidates the reservation
and the upper status have no effect on the reservation.
Reservation+planning+type+
This option let you set which planning is show during the time slot selection on checkout.
Reservation+message+
Here you can customize messages that are displayed to the customer when reservation is not
available due to reservation window constraints or when a reschedule notification is sent by order
msg and email.
Page 16 on 20
myOwnReservations
Rent your products with simplicity
User manual
Administration
To access to the admin panel, click on “My Own Reservations” on the tab “Orders” :
Month reservation view
This view allow you to easily see the reservations per day for a month :
•
•
•
A gauge representing the occupation of products concerned by the reservations for time slots
of the day as a percentage (the gauge is visible if there is base product quantity greater that 0).
The number of reservations validated (and the number of none validated reservations
between brackets).
An exclamation icon appears on days that require your attention.
A calendar on the left side let you easily switch between month or selects it. You can view
reservations per week via the 'Action' column.
Each day show a color :
•
•
•
•
•
Light yellow for day without time slot
Yellow for a day with time slots
Blue for the current day
Light blue for days available for a reservation by a customer
Grey for holidays
Page 17 on 20
myOwnReservations
Rent your products with simplicity
User manual
Week reservation view
This view allow you to easily display reservations per time slot for a week :
•
•
•
Validated reservation: blue lines.
Reservations waiting for validation: grey lines.
Order number on begin of the line.
Some links that highlights reservations let quickly apply filter on day view.
•
•
•
•
The line: shows reservations for concerned product (and all combinations) and that begin at
the same time
The time slot: shows reservation for all products that begin on concerned time slot.
The product: shows reservation for concerned product for the first day of the week.
The day: shows all reservations that run during the concerned day.
Day reservations view
This view allow you to easily see the reservations of a day ordered by time slot and by product :
•
•
A gauge representing the occupation of the time slot as a percentage and the number of
validated reservations.
The list of reservations by subareas, with the color of order status (grey if the reservation is
not validated).
Delivery details
Each reservation is displayed in details:
Page 18 on 20
myOwnReservations
Rent your products with simplicity
•
•
•
User manual
The order number and the reservation length.
The current order status and the status of the reservation.
The date and time slot of reservation begin and end.
A calendar on the left side let you easily switch between days or select a day.
A filter in the left side let you choose to show only the reservations for a time slot or for a product
or with a specific order status.
A panel at the end of the page let you reschedule or force the validation of a selected reservation.
Page 19 on 20
myOwnReservations
Rent your products with simplicity
User manual
Reservation edit
To reschedule a reservation select it and select the new day then click on the “select a time slot”
button.
The page is refreshed and shows the list of possible beginning time slots and the corresponding end
date and time slot (with time slots details and it occupation summary). Select a time slot and click on
the “reschedule” button.
If the reservation price is calculated per day, vou’ve the choice of beginning and end time slot.
Otherwise only the start time slot could be choose.
Reservations on modified time slots
When editing time sots (by deleting them or disabling some days) you should not be able to find
theses reservations, which was affected to them. If it’s the case you can find theses reservations with
this panel.
Page 20 on 20
Download PDF