Difference between revisions of "Category:Wordpress"

From Beds24 Wiki
Jump to navigation Jump to search
 
(31 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:Widgets]]
 
[[Category:Widgets]]
[[Category:Apps_Plugins_and_Extentions]]
+
[[Category:Apps]]
  ''This page explains how to install and customise the Wordpress plugin.''
+
[[Category:Booking_Engine]]
 +
[[Category:Booking_Page]]
 +
<div class="heading">Wordpress Plugin</div>
 +
  This page explains how to install and customise the Wordpress plugin.
 +
The [https://wordpress.org/plugins/beds24-online-booking/ Wordpress Plugin] allows you to add an embedded booking page and/or booking widgets via short codes.
 
==Install the Plugin ==
 
==Install the Plugin ==
 +
Add and activate the plugin
  
These [http://beds24com.clarify-it.com/d/g3cjq3 step-by-step instructions] show how to install the plugin.
+
[[Image:install_1.png|450px|link=]]
 +
[[Media:install_1.png|view large]]
  
Widgets are inserted via short codes. Use these [http://beds24com.clarify-it.com/d/g3cjq3 step-by-step instructions] for details.
+
<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If your pages is hosted on WordPress.com you might need to upgrade your plan so you can install plugins.  
  
== Opening a Wordpress page with an embedded Iframe ==
+
==Embed your Booking Page ==
By default the Wordpress will show the booking page for the ID you have set in the plugin settings or in the short code. You can also add a property ID or room ID  parameter to the URL to show a specific property or room.
 
  
Examples:
+
Adjust the general setting for your booking page. You can further customize the booking page in Beds24 in {{#fas:cog}} (SETTINGS) BOOKING ENGINE
  
[http://wordpress.beds24.com/booking-page/?propid=13434 http://wordpress.beds24.com/booking-page/?propid=13434] will open the booking page for property ID 13434
+
[[Image:embed_1.png|450px|link=]]
 +
[[Media:embed_1.png|view large]]
  
[http://wordpress.beds24.com/booking-page/?roomid=32906 http://wordpress.beds24.com/booking-page/?propid=32906] will open the booking page for room ID 32906
+
 
 +
Use the short code [beds24-embed] to add a booking page with pre populated dates.
 +
 
 +
<div class="warning">{{#fas:exclamation-triangle}}  Do not use [beds24-embed] if you redirect to the booking page from a widget. Use [beds24-landing] instead.</div> 
 +
 
 +
[[Image:embed_2.png|450px|link=]]
 +
[[Media:embed_2.png|view large]]
 +
 
 +
 
 +
Use [beds24-landing] to add a booking page which uses the dates chosen on a widgets.
 +
 
 +
[[Image:embed_3.png|450px|link=]]
 +
[[Media:embed_3.png|view large]]
 +
 
 +
See the "Documentation" section in the Plugin settings for customisation options.  
 +
 
 +
 
 +
===Embeded booking page for a  room ===
 +
You can specify the room ID in the short code for example:
 +
 
 +
[beds24-landing roomid="123"]
 +
 
 +
[beds24-embed roomid="123"]
 +
 
 +
===Embedded booking page for a specific property ===
 +
You can specify the  property ID  in the short code for example:
 +
 
 +
[beds24-landing propid="123"]
 +
 
 +
[beds24-embed propid="123"]
 +
 
 +
===Embedded booking page  for all properties ===
 +
You can specify the owner ID  in the short code for example:
 +
 
 +
[beds24-landing ownerid="123"]
 +
 
 +
[beds24-embed ownerid="123"]
 +
 
 +
===Embedded booking page for a group of properties ===
 +
If you want to create a booking page for a group only use the "custom" parameter:  custom="group=NameOfGroup" for example:
 +
 
 +
[beds24-landing ownerid="123" custom="group=NameOfGroup" ]
 +
 
 +
[beds24-embed ownerid="123" custom="group=NameOfGroup" ]
 +
 
 +
== Add Booking Widgets ==
 +
Widgets are inserted via short codes. You can generate the short codes for one or multiple properties. To generate a short code for multiple properties set the selector for "Property" = All SETTING->BOOKING ENGINE->BOOKING WIDGETS. Copy the short code from there and paste it where you want to display the widget.
 +
 
 +
===Booking Box, Booking Strip, Availability Calendar ===
 +
Short Codes for Booking Box, Booking Strip, Availability Calendar are generated in the widget designer in the Beds24 control panel in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS. Copy the short code from there and paste it where you want to display the widget on your Wordpress page..
 +
 
 +
Generate the widget in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS
 +
 
 +
[[Image:Wordpresswidget_1.png|450px|link=]]
 +
[[Media:Wordpresswidget_1.png|view large]]
 +
 
 +
 
 +
Paste the generated short code to where you want to display the widget
 +
 
 +
[[Image:Wordpresswidget_2.png|450px|link=]]
 +
[[Media:Wordpresswidget_2.png|view large]]
 +
 
 +
If you want to allow guests to search by certain criteria:
 +
*first create the search criteria in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > MULTI BOOKING PAGE > SEARCH CRITERIA then go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > MULTI BOOKING PAGE >PROPERTY SETTINGS and assign the applicable criteria to each property
 +
*Once you have set and assigned your search criteria you can go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE  > BOOKING WIDGETS. Set PROPERTY = ALL and design your widget, ensuring that you change "Search Filter" to show the search criteria in your booking widget.
 +
*Generate the code for the widget and paste it into the source code (Set the Wordpress editor to "Text") where you want to display the widget.
 +
 
 +
===Booking Button, Booking Link  ===
 +
Booking Button, Booking Link are inserted via these short codes:
 +
*Booking button: [beds24-button]
 +
*Booking link: [beds24-link]
 +
 
 +
Paste it where you want to display the widget on your Wordpress page.
 +
 
 +
For customization options for the buttons and links see the "Booking Widgets" section in SETTINGS > Beds24 in Wordpress.
  
 
== Developer Options ==
 
== Developer Options ==
Developers or users with basic knowledge of HTML, PHP and CSS can change the plugin code to customise widgets.
+
Developers or users with basic knowledge of HTML, PHP and CSS can change the plugin code.
  
  Note: If you use the "Debug" mode in Wordpress you will see warnings. These are warnings only the plugin is working. Guest will not see these warnings.  
+
=== Developer Options for legacy booking widgets ===
 +
<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Only use this method if you can not use the widgets generated with the widget designer in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS.
  
'''Example''': Change the default values of the booking box
+
'''Example''': Change the default values of [beds24-box]
  
 
Open your Wordpress dashboard and go to SETTINGS->BEDS24 then click on "Edit"
 
Open your Wordpress dashboard and go to SETTINGS->BEDS24 then click on "Edit"
Line 30: Line 111:
 
Click on on the link to edit:  
 
Click on on the link to edit:  
  
To change the default number of guests search for:
+
*To change the default number of guests search for:
if (!isset($_REQUEST['numadult'])) $_REQUEST['numadult'] = 2;
+
<code> if (!isset($_REQUEST['numadult'])) $_REQUEST['numadult'] = 2; and change 1 to your default number of guests e.g. if (!isset($_REQUEST['numadult'])) $_REQUEST['numadult'] = 1;</code>
and change 1 to your default number of guests e.g.  
+
Then click "Update File"
if (!isset($_REQUEST['numadult'])) $_REQUEST['numadult'] = 1;
 
Click "Update File"
 
  
To change the default number of nights search for:
+
*To change the default number of nights search for:
  if (!isset($_REQUEST['numnight'])) $_REQUEST['numnight'] = 1;
+
<code> if (!isset($_REQUEST['numnight'])) $_REQUEST['numnight'] = 1;and change 1 to your default min number of nights e.g.  if (!isset($_REQUEST['numnight'])) $_REQUEST['numnight'] = 3;</code>
and change 1 to your default min number of nights e.g.  
+
Then click "Update File"
  if (!isset($_REQUEST['numnight'])) $_REQUEST['numnight'] = 3;
 
Click "Update File"
 
  
To change the maximum number of guests of  search for
+
*To change the maximum number of guests of  search for
  <?php for ($i=1; $i<=12; $i++)  
+
<code> <?php for ($i=1; $i<=12; $i++)  change 12 to your max number of guests e.g. <?php for ($i=1; $i<=4; $i++) </code>
  change 12 to your max number of guests e.g.  
+
Then click "Update File"
<?php for ($i=1; $i<=4; $i++)  
 
Click "Update File"
 
  
 
You can save the file in your theme directory if you want to avoid over-writing if you update the plugin.
 
You can save the file in your theme directory if you want to avoid over-writing if you update the plugin.
  
 
+
=Troubleshooting=
 
+
See [[/Embedded_Iframe#Troubleshooting|here]] for common problems with Iframes and how to fix them.
Note: Iframes on mobile devices are problematic. Best is if you set up a special mobile page for the page where you have embedded the Iframe which opens the booking page in a new page instead of an Iframe.
 

Latest revision as of 16:27, 12 January 2023

Wordpress Plugin
This page explains how to install and customise the Wordpress plugin.

The Wordpress Plugin allows you to add an embedded booking page and/or booking widgets via short codes.

1 Install the Plugin

Add and activate the plugin

Install 1.png view large

If your pages is hosted on WordPress.com you might need to upgrade your plan so you can install plugins.

2 Embed your Booking Page

Adjust the general setting for your booking page. You can further customize the booking page in Beds24 in (SETTINGS) BOOKING ENGINE

Embed 1.png view large


Use the short code [beds24-embed] to add a booking page with pre populated dates.

Do not use [beds24-embed] if you redirect to the booking page from a widget. Use [beds24-landing] instead.

Embed 2.png view large


Use [beds24-landing] to add a booking page which uses the dates chosen on a widgets.

Embed 3.png view large

See the "Documentation" section in the Plugin settings for customisation options.


2.1 Embeded booking page for a room

You can specify the room ID in the short code for example:

[beds24-landing roomid="123"]

[beds24-embed roomid="123"]

2.2 Embedded booking page for a specific property

You can specify the property ID in the short code for example:

[beds24-landing propid="123"]

[beds24-embed propid="123"]

2.3 Embedded booking page for all properties

You can specify the owner ID in the short code for example:

[beds24-landing ownerid="123"]

[beds24-embed ownerid="123"]

2.4 Embedded booking page for a group of properties

If you want to create a booking page for a group only use the "custom" parameter: custom="group=NameOfGroup" for example:

[beds24-landing ownerid="123" custom="group=NameOfGroup" ]

[beds24-embed ownerid="123" custom="group=NameOfGroup" ]

3 Add Booking Widgets

Widgets are inserted via short codes. You can generate the short codes for one or multiple properties. To generate a short code for multiple properties set the selector for "Property" = All SETTING->BOOKING ENGINE->BOOKING WIDGETS. Copy the short code from there and paste it where you want to display the widget.

3.1 Booking Box, Booking Strip, Availability Calendar

Short Codes for Booking Box, Booking Strip, Availability Calendar are generated in the widget designer in the Beds24 control panel in (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS. Copy the short code from there and paste it where you want to display the widget on your Wordpress page..

Generate the widget in (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS

Wordpresswidget 1.png view large


Paste the generated short code to where you want to display the widget

Wordpresswidget 2.png view large

If you want to allow guests to search by certain criteria:

  • first create the search criteria in (SETTINGS) BOOKING ENGINE > MULTI BOOKING PAGE > SEARCH CRITERIA then go to (SETTINGS) BOOKING ENGINE > MULTI BOOKING PAGE >PROPERTY SETTINGS and assign the applicable criteria to each property
  • Once you have set and assigned your search criteria you can go to (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS. Set PROPERTY = ALL and design your widget, ensuring that you change "Search Filter" to show the search criteria in your booking widget.
  • Generate the code for the widget and paste it into the source code (Set the Wordpress editor to "Text") where you want to display the widget.

3.2 Booking Button, Booking Link

Booking Button, Booking Link are inserted via these short codes:

  • Booking button: [beds24-button]
  • Booking link: [beds24-link]

Paste it where you want to display the widget on your Wordpress page.

For customization options for the buttons and links see the "Booking Widgets" section in SETTINGS > Beds24 in Wordpress.

4 Developer Options

Developers or users with basic knowledge of HTML, PHP and CSS can change the plugin code.

4.1 Developer Options for legacy booking widgets

Only use this method if you can not use the widgets generated with the widget designer in (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS.

Example: Change the default values of [beds24-box]

Open your Wordpress dashboard and go to SETTINGS->BEDS24 then click on "Edit"

Search for this file in the right navigation: beds24-online-booking/theme-files/beds24-box.php

Click on on the link to edit:

  • To change the default number of guests search for:

if (!isset($_REQUEST['numadult'])) $_REQUEST['numadult'] = 2; and change 1 to your default number of guests e.g. if (!isset($_REQUEST['numadult'])) $_REQUEST['numadult'] = 1; Then click "Update File"

  • To change the default number of nights search for:

if (!isset($_REQUEST['numnight'])) $_REQUEST['numnight'] = 1;and change 1 to your default min number of nights e.g. if (!isset($_REQUEST['numnight'])) $_REQUEST['numnight'] = 3; Then click "Update File"

  • To change the maximum number of guests of search for

<?php for ($i=1; $i<=12; $i++) change 12 to your max number of guests e.g. <?php for ($i=1; $i<=4; $i++) Then click "Update File"

You can save the file in your theme directory if you want to avoid over-writing if you update the plugin.

5 Troubleshooting

See here for common problems with Iframes and how to fix them.

Subcategories

This category has only the following subcategory.

Pages in category "Wordpress"

The following 3 pages are in this category, out of 3 total. download this selection of articles as a PDF book