Official Documentation Joomla® Vik Extensions by e4j


The Booking section of VikRestaurants contains the Customers, the Reviews, the Coupons and the Invoices.


The customers view is used to collect all the details of your clients.

customer will be created automatically every time a new logged-in user places a new order from the front-end.

You can see the number of CONFIRMED reservations/orders made from your customers and you can also sort them to see a best-purchaser ranking.

Billing Details
  • User Account - the Joomla User assigned to this customer. If the customer doesn't have a Joomla User, you have to select the "Guest" option. By selecting the "Create New Account" option you will be asked to enter username, e-mail and password to create a new Joomla User. The Joomla User will be assigned automatically after saving.
  • Name - the billing full name of the customer.
  • E-mail - the billing e-mail address of the customer.
  • Phone - the billing phone number of the customer. The phone prefix (like +1) MUST NOT be specified because it will be retrieved from the selected country.
  • Country - the billing country of the customer.
  • State - the billing state of the customer.
  • City - the billing city of the customer.
  • Address - the billing address of the customer.
  • Address 2 - a secondary optional billing address of the customer.
  • Zip - the billing zip code of the customer.
  • Company Name - the billing company name of the customer.
  • Vat Number - the Vat Number of the customer.
  • SSN / Fiscal Code - the social security number / fiscal code of the customer.
  • Notes - if you need to insert some additional notes about the customer, you can use this field. This value will be visible only from the administrator.

Vik Restaurants - Customer Billing Details

Delivery Locations

The list of the delivery addresses of the customer. These addresses can be used to fill-in quickly the address custom field (take-away only), in order to calculate the delivery cost.

To create a new delivery address, just fill at least one field from the apposite form. After saving the changes, you will still be able to create a new delivery address.

Vik Restaurants - Customer Delivery Locations

Custom Fields

The custom fields filled-in during the purchase. You can leave these fields empty if you are creating a new customer from the back-end.

Vik Restaurants - Customer Custom Fields

SMS Notifications

From the customers page you are able to send custom SMS notifications by clicking on the Comics icon under the Send SMS column.
Only the blue-filled icons allows you to send a SMSNon-filled icon means the customer doesn't own a phone number.

From the dialog you are asked to insert a short message (maximum 160 characters) to send to the customer.

If you check the Remember option (keep this text as default), the message will be stored and it will be displayed as default every time you need to send a (custom) message.

Vik Restaurants - sms


If you want to receive reviews for your products, you have to configure the Reviews section in the global configuration of VikRestaurants first.

The reviews have a mandatory stars rating (from 1 to 5), a mandatory title and an optional/mandatory description (depending on the configuration of the program).

The reviews are supported only by the take-away products.

  • Title - the title of the review (max 128 characters).
  • User - the existing Joomla account of the user.
  • Name - the name of the user..
  • E-mail - the e-mail address of the user.
  • Date - when the customer submitted the review from the front-end. This value can be changed from the back-end.
  • Rating - the number of stars to represent the rating of the product (from 1 to 5).
  • Published - disable this option if you want to hide this review without deleting it. By default all the new submitted reviews are automatically published, but it is possible to disable this option to publish them only manually.
  • Verified - the verified badge means that the customer who left the review has really purchased the product.
  • Product - the product rated.
  • Language - the language tag of the review. When a customer submits a new review, the lang tag will be equal to the language set in the front-end. This option is used to filter the reviews by language.
  • Comment - the description of the review. The maximum characters length can be defined from the configuration.


The reviews are listed in 2 different pages: take-away item details and take-away item reviews.

The Item Details page can be accessed by clicking on the name of an item within the default Take-Away Menus page. These kind of pages can be also published as new menu items, so that you can have links that point directly to the details page of your items.

The Item Details page shows the latest reviews left that contain a comment. To see all the reviews left for an item, it is needed to click on the See All Reviews button to go into the Item Reviews page (see screenshot below).

The reviews are also used by the Take-Away Grid module.

Leave a Review

It is possible to leave a review only from the Item Reviews page by clicking the Leave Review button.

The fields that own the * inside the label are required to leave the review. To choose the rating you have to click the stars box, hover the mouse to the rating you need (1, 2, 3, 4 or 5 star) and click it.

If you seem to be not able to leave a review for an item, make sure you haven't already posted it (for the same item) and try to check the configuration section of the reviews.


The coupons system allows you to create discounts that will be applied to the deposit amount for the restaurant reservations or to the total cost of the take-away orders.

Coupons can be used also to save in the reservations a code/reference that could belong to one of the promoters of your restaurant.

  • Group - the group for which the coupon should be used (restaurant or take-away).
  • Code - the code of the coupon that the users will have to enter to redeem it. It can be at most 64 characters long and it can contain any letter, number or symbol. The code should not contain white spaces.
  • Type - the type of the coupon (Permanent or Gift). A permanent coupon always applies the discount when it is used. Instead, a gift coupon can be used only once, after that it will be removed from the system.
  • Value - the discount amount to apply, expressed in your currency or in percentage.
  • Date Start - the minimum date required for using the Coupon.
  • Date End - the maximum date required for using the Coupon.
  • Min. People/Min. Order - the minimum number of people needed to apply the discount (Restaurant). The minimum total cost of the orders needed to apply the discount (Take-Away).

The Invoices page is the archive of all the invoices you have generated through the internal system of the program.

The navigation on the right-side shows the list of the months that own at least an invoice. While on the other section of the page there is a grid containing all the invoices for the selected month and year. In case there are a lot of invoices, it is needed to press the apposite button(s) to load the remaining ones.

It is possible to search an invoice by:

  • order number (e.g. 684)
  • order key (e.g. D8ULGI57I6BX839D)
  • order number-order key (e.g. 684-D8ULGI57I6BX839D)
  • invoice number (e.g. 12)
  • invoice suffix (e.g. 2017)
  • invoice number/suffix (e.g. 12/2017)

The invoice filtering is always applied to the selected month and year.

VikRestaurants - Invoices Archive

By clicking the invoice name, a PDF will be opened on a different tab of your browser. By clicking the invoice icon, the invoice will be selected. The selected invoices can be deleted or downloaded. In case you need to download a single invoice, it will be downloaded as PDF. While if you need to download multiple invoices, the system will ZIP all them and it will be downloaded as a package.

Invoices Generation

From this page it is possible to generate the invoices monthly.

If you need to generate a few invoices only, you need to do it directly from the reservations/orders page.

  • Group - the group of the invoices to generate (restaurant reservation or take-away orders).
  • Reservations on - the month and the year of the reservations to generate.
  • Overwrite Existing - enable this option if you want to overwrite the existing invoices.
  • Notify Customers - enable this option if you want to send the invoice automatically via e-mail to the customers, after the generation.
  • Unique Identifier - the invoice number and suffix (e.g. 1/2017, or e.g. 1/SFX). The invoice number MUST be an integer. Every time a new invoice is generated, the invoice number is incremented by one.
  • Date - the invoice date, which can be the current day (today) or the date of the checkin (booking checkin).
  • Legal Info - a few lines of text about the legal information of your company.
  • Page Orientation - the page orientation of the invoice: Portrait (vertical) or Landscape (horizontal).
  • Page Format - the page format of the invoice: A4, A5 or A6.
  • Unit - the length unit to use for the invoice: Point, Millimeter, Centimeter, Inch. It is suggested to leave the Millimeter option selected.
  • Scale ratio - the scale ratio to use to resize the images inside the invoice (in percentage).

TIP: if you need to restore the invoice number, for example after deleting an invoice, you can follow the steps below:

  1. open the invoices page.
  2. click the NEW button
  3. select a date in the future which doesn't own any reservation
  4. restore the invoice number
  5. click the SAVE button

In this way, none invoice will be generated and the invoice number will be reset.

Template Customization

In case you need to customize the template of the invoice, you can do it by editing the following files:




/components/com_vikrestaurants/library/pdf/takeaway_invoice_tmpl.php is not affiliated with or endorsed by the Joomla!® Project or Open Source Matters.
The Joomla!® name and logo is used under a limited license granted by Open Source Matters the trademark holder in the United States and other countries.
E4J s.r.l. - VAT N. 06794860483

This site uses cookies. By continuing to browse you accept their use. Further information