Table of Contents
You can restrict or grant access to the Hotel Booking plugin, thus, for example, allow some people to only view bookings and others to perform more tasks with payments, clients, and more.
The Hotel Booking plugin provides two custom user roles for this task:
- Hotel Worker
- Hotel Manager
Note: you can use custom user roles since Hotel Booking version 4.0.0 or greater.
Custom MotoPress Hotel Booking plugin user roles (Hotel Worker and Hotel Manager) come with custom capabilities (tasks allowed to be performed).
Hotel Worker role
Hotel Worker role is the equivalent to Subscriber and has only mphb_view_calendar capability.
By default, people granted this role can view all reservations in the Booking calendar menu (Bookings > Calendar) of your Hotel Booking plugin.
That means they can’t edit bookings or add reservations; they can do only the tasks you can normally do when in the Calendar menu. By clicking on a particular reservation, they can also see more details about a booking and client:
All the other menus where you normally see the payment history or bookings are by default not accessible to a Hotel Worker.
Hotel Worker can:
- View reservations in the Calendar menu
Hotel Worker can’t:
- Work with other plugin settings and site menus
This user role is most likely suitable to the hotel staff: receptionists, room cleaners and others who normally don’t need more access than to arrival and departure dates, client names, and booking statuses.
Hotel Manager role
The Hotel Manager user role has more extensive access to the Hotel Booking plugin. It has almost all privileges the Editor role had before the plugin version 4.0.0.
Hotel Manager can:
- View all menus of the Hotel Booking plugin and configure all settings (i.e., access Accommodation and Bookings menus)
- Access the Media, Pages, and Comments menus on the site
Hotel Manager can’t:
- Access other essential administrative WordPress website settings, e.g. Plugins
This role is suitable for people who need to work a lot with the Hotel Booking plugin but must not have access to the other site data and settings.
Capabilities
The Hotel Booking plugin capabilities are sourced from default WordPress capabilities. There are three logical groups of capabilities: custom capabilities, custom post types capabilities and addons capabilities.
Custom capabilities
mphb_manage_booking_rules– the ability to view, add, and delete booking rules via the Booking rules menumphb_manage_taxes_and_fees– the ability to view, add, and delete taxes and fees via the Taxes and fees menumphb_sync_ical– the ability to sync calendars via the Sync Calendars menumphb_import_ical– the ability to add external calendars to the site via the Sync Calendars menumphb_view_reports– the ability to view CSV reports via the Reports Menumphb_export_reports– the ability to view, generate and download CSV reports via the Reports Menumphb_manage_settings– the ability to change settings via the Settings menumphb_view_calendar– the ability to view bookings in the Calendar menu.
By default, the Hotel Worker user role is granted the mphb_view_calendar capability, while the Hotel Manager has all these custom capabilities.
Using extra user role editor plugins, you can change the capabilities of either of these roles, for example, allow a Hotel Worker to sync calendars.
Note: it’s okay to grant chosen roles more capabilities but we also wouldn’t recommend you randomly and extensively editing capabilities to avoid any sort of conflicts between them.
Custom post type capabilities
delete_mphb_bookingsdelete_mphb_couponsdelete_mphb_paymentsdelete_mphb_ratesdelete_mphb_reserved_roomsdelete_mphb_room_attributesdelete_mphb_room_servicesdelete_mphb_room_typesdelete_mphb_roomsdelete_mphb_seasonsdelete_others_mphb_bookingsdelete_others_mphb_couponsdelete_others_mphb_paymentsdelete_others_mphb_ratesdelete_others_mphb_reserved_roomsdelete_others_mphb_room_attributesdelete_others_mphb_room_servicesdelete_others_mphb_room_typesdelete_others_mphb_roomsdelete_others_mphb_seasondelete_private_mphb_bookingsdelete_private_mphb_couponsdelete_private_mphb_paymentsdelete_private_mphb_ratesdelete_private_mphb_reserved_roomsdelete_private_mphb_room_attributesdelete_private_mphb_room_servicesdelete_private_mphb_room_typesdelete_private_mphb_roomsdelete_private_mphb_seasonsdelete_published_mphb_bookingsdelete_published_mphb_couponsdelete_published_mphb_paymentsdelete_published_mphb_ratesdelete_published_mphb_reserved_roomsdelete_published_mphb_room_attributesdelete_published_mphb_room_servicesdelete_published_mphb_room_typesdelete_published_mphb_roomsdelete_published_mphb_seasonsedit_mphb_bookingsedit_mphb_couponsedit_mphb_paymentsedit_mphb_ratesedit_mphb_reserved_roomsedit_mphb_room_attributesedit_mphb_room_servicesedit_mphb_room_typesedit_mphb_roomsedit_mphb_seasonsedit_others_mphb_bookingsedit_others_mphb_couponsedit_others_mphb_paymentsedit_others_mphb_ratesedit_others_mphb_reserved_roomsedit_others_mphb_room_attributesedit_others_mphb_room_servicesedit_others_mphb_room_typesedit_others_mphb_roomsedit_others_mphb_seasonsedit_private_mphb_bookingsedit_private_mphb_couponsedit_private_mphb_paymentsedit_private_mphb_ratesedit_private_mphb_reserved_roomsedit_private_mphb_room_attributesedit_private_mphb_room_servicesedit_private_mphb_room_typesedit_private_mphb_roomsedit_private_mphb_seasonsedit_published_mphb_bookingsedit_published_mphb_couponsedit_published_mphb_paymentsedit_published_mphb_ratesedit_published_mphb_reserved_roomsedit_published_mphb_room_attributesedit_published_mphb_room_servicesedit_published_mphb_room_typesedit_published_mphb_roomsedit_published_mphb_seasonspublish_mphb_bookingspublish_mphb_couponspublish_mphb_paymentspublish_mphb_ratespublish_mphb_reserved_roomspublish_mphb_room_attributespublish_mphb_room_servicespublish_mphb_room_typespublish_mphb_roomspublish_mphb_seasonsread_private_mphb_bookingsread_private_mphb_couponsread_private_mphb_paymentsread_private_mphb_ratesread_private_mphb_reserved_roomsread_private_mphb_room_attributesread_private_mphb_room_servicesread_private_mphb_room_typesread_private_mphb_roomsread_private_mphb_seasons
The ‘others’ parameter means a user role can modify posts created by other people.
Hotel Worker (and other roles, except for Admin and Super Admin) doesn’t have access to capabilities associated with the Hotel Booking custom post types. At the same time, the Editor, Contributor, Author user roles have access to the Shortcodes menu.
Capabilities of addons
If you use Hotel Booking addons along with the core plugin, there are custom capabilities for them, too.
These capabilities will also start with the mphb prefix (for example, the Payment Request addon adds its custom capability mphb_send_payment_request).
Manage user roles
Find all site users via WordPress dashboard > All Users. In this menu, you can see a list of users with their assigned user roles and also add new users or change their roles.
In order to manage what users of your site/plugin can do, we recommend you to install a preferable user role editor WordPress plugin to edit capabilities in a user-friendly way. For example, the User Role Editor will do the job.
If you use this plugin, you can find the list of user roles on your site and the list of capabilities by heading to WordPress dashboard > Users > User Role Editor.
It’s also required to configure initial settings: WordPress dashboard > Settings > User Role Editor.
The User Role Editor plugin also allows you to assign Hotel Booking sourced roles as additional roles to new or existing users.
With this plugin, you can also have one person granted two different roles, for example, to manage a WooCommerce store (which requires a WordPress user role of its own) and the hotel booking site, too.
You can use these free WordPress plugins to modify user roles and capabilities:
Furthermore, you can create custom user roles and grant them preferable capabilities:
