Italian (Italy)

Vik Rent Items Official Documentation

Vik Rent Items - Documentation

Version: 1.0

Rental

This menu groups some pages of the first setup of the plugin.

Tax Rates

Vik Rent Items - Tax Rates

The Tax Rates should be created as one of the first contents because they are used by any rental fare and Option.
The system supports multiple tax rates to be assigned to different Items or services. Taxes will be displayed as 0.00 if they are not specified or assigned to the rental fares.
A Tax Rate requires a name for management purposes and a percentage value.

Types of Price

The Types of Price are a mandatory step for the initial setup. The system requires at least one type of price to be configured for the whole site.
For each Type of Price you will be able to specify the exact rental cost for any item and for any duration (days, hours, extra hours).

The Name and the Tax Rate are the two mandatory information. The Attribute is a value that change on any day or hour of rental to give a different information to the customer. The Attribute is not mandatory.

An example of Type of Price is 'Rental Cost', 'Basic Insurance', 'Full Insurance'. If you are willing to offer more than one price for your Items, then you should create multiple Types of Price. Customers will be asked to choose the Type of Price in the page after the search results for the item(s) selected. If there is only one Type of Price the choice will be forced to that only Type of Price. If there are more than one, the user will have to choose the desired rental option. If there are no Types of Price defined, the booking will not be allowed.

Pickup/Drop Off Locations

Vik Rent Items - Pickup and Drop Off

 

This function lets you manage all the locations for Pickup and Drop Off where the Items are available. Using the Locations is not mandatory so just don't create any if you don't need a filter by location in the search forms.

The locations are disabled by default in VikRentItems, this means that the setting in the Configuration must be enabled to make the users select them. The same thing works for the search modules that have their own parameter.

A location is composed of various details:
- latitude and longitude, these values will be used by the location map in the front end to place a marker on the Google Map. If empty, no map will be displayed or no marker will be used for this location.
- tax rate override, the locations can override the global tax rate assigned to the Items, the Options and the Pickup Drop Off Fees. If empty, the system will use the global tax rate.
- Opening Time that can be different from the other locations or from the global setting 'Store Opening Time'.
- closing days for pickup or drop off can be set for this location.

Time Slots

With the Time Slots you can create selectable options that will replace the selection of the Hours and Minutes for the Pickup and Drop Off. They limit the reservations time to 24 hours at most.
Give the time slot a Name that the user will have to select, Half-Day Morning for example and select the Pickup and Dropoff time to be applied when this Time Slot is selected.
Select one or more Items from the multiple select to be assigned to this Time Slot.

In case the system will have two consecutive Time Slots, for example Half-Day Morning that goes from 8:00 AM to 2:00 PM and Half-Day Afternoon that goes from 2:00 PM to 8:00 PM, make sure that you set the minutes to 45 instead of 00 to avoid availability problems with the Items. In the example above, the Time Slot Half-Day Morning from 8:00 AM to 2:00 PM should be set like this: 8:00 AM to 1:45 PM. This way the system will still consider 6 Hours of Rental but the items will be available at 2 PM for the Pickup of the next Time Slot Half-Day Afternoon.

Time Slots can be applied to the single items or to the whole system by enabling the setting Use in Global Search. If you want the users to be able to manually select the hours and the minutes from the search form of the plugin, don't enable that setting in any Time Slot.

Restrictions

 

items_booking_restrictions

Restrictions are rules that can be set up to define some limits for the orders on some dates of the year. For example, to force a minimum number of days of rent on some dates of the year, you can create a Restriction. The same thing works if only for some dates you want to set a maximum number of days of rental.

Terms like "CTA" and "CTD" stand respectively for "Closed to Arrival" and "Closed to Departure". You should enable these parameters in your Restrictions if you would like to disable pick up (arrival) and/or drop off (departure) on some week days in your restriction dates.
Thanks to the Restrictions you could also force the pick up on a specific combination of week days, or define a minimum length for the rental with a multiplier, like 7 days, 14, 21 etc.

Please notice that only one restriction can be applied on some specific dates, and a Restriction that sets just a 1 day as minimum rental period is NOT considered as a valid restriction. That's because 1 day is already supposed to be the minimum duration of the rental.

Items
Categories

Vik Rent Items - Categories

The Categories are used to filter the results of the search function or to list the Items in the front-end under different Categories. The use of the Categories is not mandatory and sub-Categories are not supported.

The use of the Categories is disabled by default so make sure to enable it from the Configuration page and from the settings of the search form.

To list the items of a certain category in the front-end, it is sufficient to create a new WordPress Shortcode of type 'Items List' with a Category ID as filter. The View in the front-end will display the items of that category only.

Options

Vik Rent Items - Items Options

The Options are Extra Services that users can select and add to the rental order. Their use is not mandatory and the selection is displayed in the page after the search results.

Options could be anything related to the Item, like a basket for a Bike, a Helmet for a Scooter or a mounting kit for for Inflatables.

You will be asked to specify a name, a description and the cost for that option. Tax rates are not mandatory and they could be different from one option to the other.
Options could be configured to be always selected. This way the system will force their selection in the front-end and any item using that option, will automatically add it to the cart. This is how you make an Option mandatory, and it's useful to have a separate row for the service in the summary, confirmation email and PDF.

Selectable Specification: if you enable this parameter for your Option, you will be able to specify different specifications for this service, with an optional extra cost. This function is useful when you need the customers to select a specific color, size or characteristic of the item. NB.: if enabled, this parameter will make this Option mandatory and automatically added to the cart, just like the "Always Selected" parameter does.

Selectable Quantity: this is a useful parameter that rather than displaying the Option with a checkbox in the front-end, it will show an input of type number for the users to enter the desired value/units for the Option.

Apply Once per Order: if enabled, this parameter will exclude from the booking any Option that is already in the cart. This way, one Option/Extra Service can only be ordered once, no matter if the rental order contains multiple items.

Apply Once per Item: if enabled, this parameter will not let the system multiply the cost of an Option by the number of units booked.

The Options can be assigned to the items from the Edit page of each Item. Multiple items could use the same Options.

Characteristics

Vik Rent Items - Characteristics

The characteristics of the items have just a visual purpose. They are just icons displayed for each item in the front-end and they should be used to differentiate the characteristics of similar items.

The Characteristics do not affect the search results, nor they could be used as filter.

Items

 

Before creating any Item, it is suggested to have created at least one Tax Rate (optional) and one Type of Price (mandatory). Categories, Characteristics and Options could be added later.
By clicking the New button, the system will ask to provide some details for the creation of the Item for rental:
Name (should be unique as it is used for the generation of the SEF Alias), the main image of the item, some extra photo for the image gallery, the categories to which the item is assigned, the description texts, the units available as full inventory and the parameters.
If the Locations exist, it is necessary to select where the pickup and the drop off is available. A multiple selection is available by clicking on the locations while holding the Ctrl (cmd for Mac) button. The same multiple assignment is available for the Categories, for the Options and for the Characteristics.
An important setting of the Item is the units field. This number will be used for checking the remaining availability during the search function and the whole booking process. This will determine the number of times the item can be booked on the same dates and times. The remaining availability is calculated by checking all the confirmed rental orders that include the requested rental dates. If there are still some units available, the booking will be allowed. An error message will be raised otherwise.

Groups/Sets of Multiple Items:
Since the version 1.5, it is possible to create an item that contains multiple items in various quantities. Here is a graphical example of how to define an item as a "Group/Set of Multiple Items":

Groups/Sets of Multiple Items

In this example, we have created a set of multiple items that includes 3 units of the item "Hammer PRO", 4 units of the item "Screwdrivers" and 2 units of the item "Magic Drill". By booking one unit of this item on certain dates, the availability will be reduced as follows:
- Set of Items booked: -1 unit
- Hammer PRO: -3 units
- Screwdrivers: -4 units
- Magic Drill: -2 units
However, if another customers will decide to book singularly one of the items contained in this Group/Set, the availability would be reduced also for the "parent" item, so for this Set of Multiple Items. In this example, if you booked one unit of the item "Magic Drill", which is part of a group, the availability would be reduced also for the Group/Set of Items by 1 unit, beside of course reducing one unit available on those dates for the "Magic Drill".
The items that are part of a Group/Set of Multiple Items, should not be part of another Group-item. In short: children-items should only be part of one parent-item.

Items Parameters:
Each Item can have its own configuration for some views and functions of the front site.
Custom Starting From Price and Text: Set a custom Price and Text that will be shown in the Item Details page (20 Euro per Hour for example). The custom text accepts language definitions that are inside your .ini language file for the front site. By default the English language file has two definitions declared: VRI_PERHOUR (per hour) and VRI_PERDAY (per day).
Ask for Quantity: if this parameter is enabled, the search result and the item details pages will show an input field where the user will have to enter the desired quantity for the item.
Show Discounts per Quantity: a table showing all the discounts per quantity ordered of the item will be shown in the search results and item details pages.
Show Hourly Calendar: when enabled, the Item Details page will show a calendar with the hourly availability of the item for the selected day of the month.
Use Time Slots: if disabled, the users will have to manually select the hours and the minutes for the Pickup and Drop off.
Set Drop Off Date to x days after the Pickup: if the time slots are disabled or not available for the item, the Item Details page will automatically set the Drop Off date to 0 (the same day as Pickup), 1, 2, 3.. days after the selected Pickup Date. Leave this field empty for not setting any Drop Off Date automatically.

After clicking the Save button, you will be redirected to the fares-management page. Without completing this step, the rentals will not be allowed in the front-end as there are no costs defined.
The rental costs can be specified for daily rentals or for hourly rentals if shorter than 24 hours. Extra hours charges are supported too, to apply a charge, for example, on rentals lasting 2 days and 3 hours, for the 3 extra hours.
The creation form will let you specify a rental cost for each Type of Price defined. It is not required to set a cost for any Type of Price in case some are for certain items only. The rental fares are mandatory for at least one Type of Price or there won't be rental costs for this item.

It is important to specify a cost for any duration of the rental allowed or bookings will not be allowed. For example, if an item is requested for 3 days of rental, the system requires to have the cost for 3 days or the booking will not be allowed. When using hourly rates, having a cost defined for 1 day of rental is mandatory. Then, if a cost in the Hourly Fares exists for the number of hours requested, the system will charge that fee rather than the one for 1 day. The cost for 1 day of rental is required in case the system will need to revert to the daily fares because no hourly fares are available.

Example:
If you would like to set the rental costs for the Type of Price 'Rental Cost', you should enter the fares as follows:
- From 1 to 5 days, cost per day = €50.
This would generate the costs up to 5 days of rental where 5 days would cost €250. In this case, rentals would be allowed only up to 5 days as no fares have been defined for a number of days of rent greater than 5.

From the table/grid below the creation form, it is possible to edit the cost for each day of rental. This is useful for setting the exact rental cost for any duration of rental.

Related items

Relations between Items can be created in a multi-to-multi way. Give the Relation a name (that will not be shown anywhere) and then select some items from the two multiple selects.
The Items on the right will be related to the ones on the left.

Orders
Current Orders

Vik Rent Items - Current Orders

This page shows the list of all the orders received with their status. There are some filtering functions available to easily locate certain rental orders and you can access the order details page by clicking on each record.

Orders with status 'Stand-by' can be manually set to 'Confirmed' and the remaining availability will be updated for those dates. It is also possible to modify or remove certain orders.

When editing an order, it is necessary to select one Type of Price in order to update the total amount. Orders with no fares selected, because manually generated from the page Calendar, will show a total amount of 0.00.

Calendar

The page Calendar is useful to have an overview of the remaining availability of a certain item on some months of the year.

By using the Quick Reservation form at the top of the page, it is possible to manually save a rental order received over the phone or in any other off-line. The Quick Reservation form will block out some units of each item on the selected dates or even all the units by closing the Item.

From this page it is also available the iCal Sync URL for the Item selected. This sync URL can be used for any online Calendar system like Google Calendar, Hotmail, Yahoo, iCalendar etc..
This function is only available for the download of the availability by third parties calendar systems. It is not possible to import the availability in Vik Rent Items from an external calendar as some relations with the IDs are necessary.

Using the iCal Sync URL is useful for keeping an external calendar up to date and to monitor its availability through mobile devices. The iCal Sync URL contains your iCal Secret Key that could be changed from the Configuration page. It's a security measure to prevent others to import your rental orders remotely and the Secret Key is generated as a random string during the installation of Vik Rent Items.

Overview

Vik Rent Items - Orders Overview

The page Overview shows the remaining availability of each Item on the selected month of the year. This page is useful to easily locate the rental orders of certain dates.

Pricing
Fares Table

This is the default Rates Inventory of each Item. Rates are expressed by duration of rental in Days, Hours or Extra Hours. Items that have no fares configured, will not be bookable in the front-end.

For altering the default rental costs of the page Fares Table, on some dates/seasons/festivities of the year, please refer to the Special Prices section of the Documentation.

Daily Fares

The system will always require to have the cost for 1 day of rental if you are willing to offer hourly rentals as well. For adding your daily costs, use the form displayed at the top of the page and make sure the Item selected in the drop down is the right one.
You will be able to specify a cost for each Type of Price and it is possible to add a rate for a specific type of price only for a certain duration. For example, it is possible to add a cost for the "Full Insurance" rate plan only from 3 days of rental or more by not setting any cost for that Type of Price for 1 or 2 days.
Rates can be added by using the form like this:

- From 1 - to 3 Days: EUR 50 per day.

This will populate the rates up to 3 days of rental and 3 days will cost EUR 150. With the current configuration, 4 days of rental would not be allowed for this item because there are no rates defined.
Rates can be modified by using the input fields displayed in the grid below the creation form and then by clicking on the Update Fares button on the top-right of the grid. Rates can be removed day by day by selecting some with the checkboxes and by clicking on the toolbar button Remove Fares.

Hourly Fares

The hourly rates are applied only to rentals shorter than 24 hours. The system will calculate the exact duration of the rental from the pick up date and time and the drop off date and time. If you are using the Time Slots, the system will apply the duration defined and still calculate the length of the rental.
If there is a cost for 1 day of rental and a cost for the calculated hours, the system will apply the cost for that amount of hours defined in the Hourly Fares tab.

If there isn't a cost for the number of hours requested, the system will apply the tariff for 1 day of rental. In case the cost for 1 day is missing, the system will raise an error and the item will not be bookable.

Extra Hours Charges

The Extra Hours Charges are only applied to rentals greater than 24 hours. For example, a rental lasting 2 Days and 4 Hours can be charged for the 4 extra hours.

The system always calculates the exact duration in Days and Hours for each rental. Given the example above of 2 Days and 4 Hours, the system will check if a charge for 4 Extra Hours is defined in the Fares Table. If there is a cost for 4 hours, the system will apply the cost for 2 days of rental + the charge for 4 extra hours. If a cost for 4 extra hours hasn't been defined, the system will apply the cost for 3 days of rental in that example.

There is a configuration setting to ponder the calculation of the days and hours of rental, it's the "Hours of Extended Gratuity Period". In the example of 2 Days and 4 Hours of rental, if that configuration setting was set to 3 Hours, the system will check if a charge for 1 Extra Hour is defined. If so, the system will apply the cost for 2 Days of rental plus the charge for 1 Extra Hour because 3 hours are free. Again, if that configuration setting was set to 4 hours, a rental for 2 Days and 4 Hours would be charged for just 2 Days, no matter if there are Extra Hours Charges defined.

Special Prices

With the Special Prices it is possible to alter the default rental costs on some dates/seasons of the year. The pricing system of Vik Rent Items is based on the length of the rental expressed in days. The minimum duration that could be charged or discounted is 1 day of rental. Hourly rentals shorter than 24 hours will be treated as 1 Day even though a different rental cost could be applied.

Vik Rent Items -  Special Prices

By clicking the New button you can create a Special Price for certain dates of the year or for some week-days. With this function you could create Seasonal Rates or simply modify the default rates on some periods.

If one Special Price affects more than 7 consecutive days, then it is not necessary to select the week-days as filter. The two filter could be combined but it's useless to select both dates and week-day when the dates span is longer than 7 days.
It is possible to apply the rates-modification only in case the pick up date is after the beginning of the season. This filter could be useful for dates touching multiple special prices.
The Name of the Special Price will never be displayed in the front-end, it is used just for management purposes.

The Special Prices can apply charges or discounts to the default rates of the Fares Table. The rates modifications can be expressed as fixed amounts (+€ 20 / -€ 30) or percentage values (+20% / -30%).

It is also possible to override the default value depending on the number of days of rental thanks to the Value Overrides function.

The Special Prices are not related to the year but rather to the day and to the month.

Pickup and Drop Off Fees

Pickup and Drop Off Fees

The system supports fees for the Locations chosen for pick up and drop off. This function should be used only if the Locations are requested in the booking process.

By selecting the exact combination of locations, it is possible to apply a fee to the rental order. Like +€ 50 from Location A to Location C.

The default fees could be increased or lowered depending on the number of days of rental thanks to the function Value Overrides.

Discounts per Quantity

When more that one unit of the item is orders, it is possible to apply discounts to the rental cost of each item. The discounts per units are always applied at the end of the cost calculation, this means after having applied the Special Prices and the Extra Hours Charges.
You will be asked to enter a name of the discount (that will never be shown), the quantity selected and the value, absolute or percentage that will be deducted from the cost of the single unit of the item.
The discount can be applied even if the number of units ordered is greater than the one in the Discount by enabling the setting Apply if More Units are requested. Discounts can be applied only to some of the Items.

Fares Overview

items_faresoverview

This page is very useful to have an overview of the rates, seasonal prices and restrictions applied to certain items. It has a Rates Calculator tool that will let you check immediately the cost that will be displayed in the front-end for bookings.

Calendar Pricing

You should use the Calendar Pricing tab to adjust the rates of any date of the year for your items. Rather than using the Special Prices, you can easily set the exact rate you want to apply to an item on a specific period

items_calendar_pricing

Coupons

Vik Rent Items - Coupons

The use of the coupon codes guarantees self-discounts applied from the front-end. Only one coupon code per order is allowed.
The coupon codes are composed of:
- a unique code of any length up to 64 chars.
- a type, either Permanent or Gift. A gift coupon will be removed after its use.
- the discount amount, either a fixed amount or a percentage value of the order total (options and fees included).
- filters for the items that can use the coupon code.
- filters for the dates of validity.
- filter for the minimum order total.

The coupon codes can be entered from the front-end, from the last page of the booking process (Order Confirmation). The coupon codes are not listed anywhere in the front site and the administrators should manually inform the customers of their existence.

Search Statistics

From the Configuration of VikRentItems you can enable the saving of the statistics to log data every time a user searches for items. The system will log the information about the dates requested and the results obtained.

Scheduled Cron Jobs

To know more about Cron Jobs read our Knowledge Base section

Global
Configuration

Vik Rent Items - Configuration

The Configuration of VikRentItems is divided into 5 tabs

Shop and Rentals:

From this tab of the configuration there are a lot of important settings.

  • Enable Rental - With this option you can enable or disable the rental service, an offline message is available
  • Shop Opening Time - All the reservation forms will have this configuration
  • Hours of Extended Gratuity Period - This setting defines the hours that the plugin should consider before applying the rate for the next day. For example, Pickup on the 26th at 10am and Drop Off on the 28th at 11am will be considered as 3 days of rental if this setting is 0, if it was 1 or more hours, the fare would be for 2 days of rental.
  • Dropped Off Item is available after -This defines for how many hours the item should be still considered as not-available after the Drop Off. Sometimes items might need a few hours of maintenance before being available for the next rental. The system considers the single unit of the rental order
  • Require Login - If this setting is on the user will be forced to register or login before saving the order.
  • Admin e-Mail - The eMail of the administrator that will receive the rental orders
  • Minutes of Waiting for the Payment - When the order is confirmed, the unit of the item is locked, it's considered as Confirmed while the user is making the payment. After these minutes the unit will become available again unless the order is Confirmed with a Payment or from the Administrator
  • Token Form Order Submit - This is a security measure that saves a crypted value in the session. Made for avoiding spam orders

Prices and Payments:

  • Currency Name - Some task of the front end uses a name instead of the symbol to display the currency. This could be EUR or USD for example.
  • Currency Symbol - The symbol of your currency, you can also use html entities here.
  • Transactions Currency Code - Usually a heading tag placed on top of the pages in the front end, this can be your company name. This value can also be empty.
  • Payments Account - Payments Account
  • Pay Entire Amount - Disable this setting and put a percentage value for the deposit. The total amount that the user will pay will be calculated using this value.
  • Prices Tax Included - If this setting is disabled and a tax rate exists and is assigned to the fare, taxes will be added to the total price.
  • Payment Transaction Name - Some method of payment like Paypal can use this setting as the transaction name

View:

  • Show Partly Reserved Days - In the Items List task (not the search results) of the front side you can view the details of each item and then make a reservation of it. This setting defines wether the program should put as yellow the days when the items has some reservations but not all the units are booked. The cell can't be red because some units of the items are still available.
  • Number of Months to Show - Still in the same task as above, some calendars are shown, this setting defines how many after the actual month.
  • Opening Page Texts - You can write an opening and closing text for the page where the user makes the reservation with the form.

Statistics and Orders:

  • Enable Search Statistics - With this setting the system can save a report of each search made from the front site that will be available in the Search Statistics page of the Administrator. If the setting below Send Search Notifies to Admin is enabled, an email will be sent to the admin email address of VikRentItems with the information about the search performed.
  • Attach PDF to the order eMail - If this setting is enabled the system will generate and attach a PDF file to the order email containing the information loaded from the template file for the Invoice/Contract (see the section PDF Invoice/Contract Customization for more details).
  • Company Logo - The logo of your company, a jpg, gif or png image file that will be included in every order email.
  • Footer Text Order email - This HTML text can be placed in every order email at the bottom of the page.
  • Disclaimer - a text showed in the page of the front site when the user is selecting the rental price and the options. This should not be used for the Terms and Conditions. Read the Custom Fields section for further information.

Delivery Service:

If you would like to use the Delivery Service for some or all of your Items, then it's necessary to enable it from the Edit page of each item before properly configuring the other information.

  • Company Base Address - The base address of the company, from which deliveries will start. Enter a syntactically valid office/home address, and click the button "Validate Address" to let the system gather other information about your location through the Google Maps APIs. Please notice that the system requires to validate your address in order to save some useful and mandatory information for the calculation of the distance between your company and the customer's address.
  • Latitude - This information will be populated by the system after you click the Validate Address button.
  • Longitude - Same as for the Latitude. This is a read-only field that the system populates automatically.
  • Calculation Unit - Choose whether the distance should be expressed in Kilometers of Miles. This obviously depends on your country of residence.
  • Round Distance to Integer - To avoid the use of decimals, like 5.5 Km or 5.5 Miles, turn on this setting to round decimals to integers.
  • Cost per Calculated Unit - This is the cost per unit of distance. For example, EUR 20/Km.
  • Round Cost to Integer - Turn of this setting to round decimals into integers for the calculation of the delivery cost.
  • Delivery Cost per Order - If enabled, the cost for the delivery will not be multiplied or calculated for any other item in the cart. No matter how many items are rented, the delivery fees will be the ones that are calculated at first.
  • Delivery per Item Quantity - It is possible to multiply the delivery fees by the number of units booked for a certain item.
  • Maximum Distance - The maximum number of either Km or Miles for allowing the delivery. Leave it empty to not set a limit.
  • Maximum Cost - The maximum cost that could ever be applied for the delivery service.
  • Delivery Notes - These notes are only displayed within the page where the customers are asked to enter their address for the delivery.
Payments

Vik Rent Items - Payments

From this task you can manage the methods of payment for your website. Paypal and Bank Transfer are pre-installed but disabled after the installation.
The methods of payment affect the order status that can be Pending or Confirmed.
In case of all the methods of payment are disabled, each order received is considered by the system as Confirmed and the user will not be asked to select any method of payment.
Paypal is a method of payment that processes a server response, to enable this payment you have to publish it and then from the Configuration you have to provide the Account for Payments.


Bank Transfer instead doesn't need to validate any external response.
By clicking on the title of the method of payment, the edit/configuration task will be opened

The Payment Name is the title showed in the front site during the order confirmation when the user has to select a method of payment.
The File Class is a php file that is executed by VikRentItems to validate the payment, do not change this unless you are creating a new method of payment.
Take a look at the documentation about creating a custom method of payment for VikRentItems.

A method of payment can apply a charge or a discount to the total order. From the setting Charge/Discount you can enter an amount, percentage or value that will be added/deducted from the order total. This can be useful if you want to give your clients a discounts if they are paying by credit card.
The parameter Auto-Set Order As Confirmed tells VikRentItems which status should be given to the rental order when saving it.
For the methods of payment that have to validate a payment via a server response like Paypal, this setting as to be OFF or the reservation will be Confirmed before even receiving the payment.
For other methods of payment instead this setting could be useful as ON, for example you could rename the Bank Transfer as Cash at the Office and the order would be condidered as Confirmed, making the unit of the hired out item not available for the order dates.
All the Pending Orders can be set as Confirmed manually from the Administrator - Current Orders task.
Another field that every method of payment can have is the Notes, a text displayed in the order page in the front site. Usually the notes are shown only if the order is Confirmed, by setting the option Always Show Notes as Yes, the notes will be shown in the order page even if the status is Confirmed. For those who use Bank Transfer, this could be useful for showing the information for the payment or other details.

Custom Fields

Vik Rent Items - Custom fields

From this task you can manage all the fields that the users will have to fill in before saving the order.
During the first installation of VikRentItems, some fields are created by the program but it's always possible to manage these fields.
The field types are:

  • Text - the user will have to fill in an input text field
  • TextArea - a text area with more rows will be shown
  • Select -a select menu is shown in this case, you can create all the select options from the same task
  • Checkbox - a checkbox field will be shown
  • Separator - this field is not an input field but just a text separator. It can be used for dividing the Driver's Information from the Billing Information. If the text of this field is longer than 30 chars, a different style will be applied to it. Some people use for writing extra information.

The field name is the label that will be next to the input field or the text of the separator.
If your website is multilanguage, the label should be a definition inside the .ini language file of each language that you have.
For example, the field Address should have a label like ORD_ADDRESS and each .ini file of VikRentItems that you have should contain a row like this:
ORD_ADDRESS="Address"
Take a look at the Answers Area F.A.Q. for furter information about languages and .ini files.
A field can be required or not, in this case the system will check that the user provided something for that information.
If the field type is Text and the setting Is Email is On, that email will be used to send the order email.
Another important setting of the fields is the Popup Link. This function is usually used when the field type is Checkbox and the user has to accept something, the Terms and Conditions for example. The popup link is a page that is opened in a modal box every time the user clicks on the label of the field. The modal box is "modern" popup that is never blocked by any browser and leaves the user in the same page.
Usually the link should be a WordPress article link.

Recommended Custom Fields Configuration

F.A.Q.
Basic Setup
Administrator Section

Basic Setup of the Plugin

In order to start using the plugin on your website and allowing bookings, you need to set up some basic contents and functions:

  1. Tax Rates: create at leat one tax rate that you will need for configuring the next steps.
  2. Types of Price: create at least one type of price so that you will be able to manage your rental costs. "Full Insurance" is an example of a type of price.
  3. Locations: create your locations available for Pickup and Drop Off. In case you don't want to use the locations just don't create any.
  4. Items: you can now create the first Item with images, descriptions and other settings. Remember to assign the Item to the necessary locations and categories where the pick up and drop off is available (only if you are using the locations and/or the categories).
  5. Fares Table: after having completed the steps above, you will be redirected to the page from which you can insert the costs for each day/hour/extra hour of rental for your Item. It is important to have the Fares Table set up correctly or you might get no results in the front site. For example, if you are making a search for 4 days of rental and you don't have a cost defined for 4 days in the page Fares Table, then that item will not be displayed in the search results. If there are no items available for the requested dates or period, you will get a no results error message.

The very basic setup of one item is now complete. You may want to check the Configuration page to adjust some settings. A lot of other features are available in the Administrator section like the Options, the Categories, the Characteristic

Front-end Section

Once you have at least one item set up correctly you can proceed to publish Shortcodes and Widgets in the front site.

  • Shortcodes:  From the Administrator section, Dashboard, you can create new Shortcodes by clicking on New from the Shortcode button at the top of the page. From the creation form, select the Type of the Shortcode. For starting, it is recommended to use the Items List, the Order Details and the Search Form. Give your shortcode a name and save. Now you add each shortcode in a new page of WordPress and, in the front-end, that page will show the shortcode of VikRentItems.
  • Widgets: inside the package that you have downloaded you will find some VikRentItems widgets that you can configure from the Worpress Administrator section - Appearance Menu > Widgets.
PDF Contract/Agreement
PDF Customization

If the Configuration setting for attaching the PDF to the order eMail is enabled or if the PDF generation is requested from the Administrator panel, Order Details page, VikRentItems parses all the information of the Order and then invokes a template file that gives the layout and style to the PDF that can be used as Invoice and/or Contract.
The template file is the following:
wp-content/plugins/vikrentitems/site/helpers/pdf_tmpl.php
VikRentItems will replace all the special directives inside the brakets {}. You can move them or place them inside any html tag that you want. All the occurrencies of echo JText::_('VRI...'); are language definitions that can change depending on the language in use. Make sure that those language definitions are available in the .PO and .MO files for the front-site and for the administrator section or you might have problems when generating the PDF from the Administrator section.
You can add pages to the PDF by using the code {vri_add_pdf_page}. By default, this template file renders the first page with the order details and then, after adding another page, generates a sample text with some information entered by the user (or the Administrator) with the Custom Fields. By using the code {customfield 2} the program will replace it with the Custom Field ID 2 which is the Name by default. Check the Custom Fields page to see the IDs of the fields.

PDF Troubleshooting

The PDF is generated only if the order status is CONFIRMED, if the setting in the Configuration is enabled or if the generation is requested from the Order Details page.
Custom Fields are not being Replaced: if this happens, make sure that the Customer Information text contains the right values. If the order for whom the PDF is generated was made from the Administrator, the Customer Information text must follow the replacing syntax which is: Custom_Field_Name: Value Entered (New line, Enter). From the Calendar task of the Administrator, when you are making a Quick Reservation, click on Populate Customer Information from the Options and then add the values for each custom field. This way the system will replace the Custom Fields.
Blank Page/Error when generating the PDF: this usually depends on the images that are not found by the system. If you added some image tag into the template file or if the Footer Order eMail Text of the Configuration loads some images, make sure that all the tags have this syntax:
<img src="/images/your_image.jpg" border="0" alt="..." />
Text Encoding Problems: in case the PDF file is showing some strange character, you need to use a different font for the PDF. The default font used is Helvetica, a light font but that doesn't support all the languages. Inside the full package archive of VikRentItems that you downloaded there's a folder called Dejavusans_PDF_Font. Upload all the files contained in that folder (not the folder, just the files inside) onto the following directory of your server:
wp-content/plugins/vikrentitems/site/helpers/tcpdf/fonts/
This way VikRentItems will use the font Dejavusans and every character will be encoded correctly. The reason why the program doesn't come with this font pre-installed is because it weighs about 5MB, too much for a WordPress installer.
TCPDF ERROR: [IMAGE] Unable to get image: ..... if you are getting a similar error then the problem can be caused by two different situations.
#1: Your server doesn't have the cURL libraries of PHP installed.
#2: Your virtual host doesn't have the permission to access files from an absolute path.
You can try to edit the PDF template file (/helpers/pdf_tmpl.php) and change {logo} into an image tag like this:
<img src="/images/mylogo.jpg" border="0" />
This should fix the situation #1 and in some cases also the situation #2. If you keep getting the same error message then you should contact your hosting provider and show them the error message. Installing cURL should fix the issue as well.