PHPackages heimrichhannot/contao-resource-booking-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. heimrichhannot/contao-resource-booking-bundle ActiveContao-bundle[Utility & Helpers](/categories/utility) heimrichhannot/contao-resource-booking-bundle ============================================= Book and manage resource objects with this bundle for Contao Open Source CMS. 0.1.5(4mo ago)140LGPL-3.0-or-laterPHPPHP ^8.2 Since Feb 16Pushed 4mo ago1 watchersCompare [ Source](https://github.com/heimrichhannot/contao-resource-booking-bundle)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-resource-booking-bundle)[ RSS](/packages/heimrichhannot-contao-resource-booking-bundle/feed)WikiDiscussions main Synced today READMEChangelog (3)Dependencies (22)Versions (7)Used By (0) Resource Booking 📦🗂️ for Contao =============================== [](#resource-booking-️-for-contao) This bundle provides resource booking capabilities for the Contao Open-Source CMS. Note This bundle is in early development. We welcome any feedback and contributions. Installation ------------ [](#installation) Install the bundle via Composer: ``` composer require heimrichhannot/contao-resource-booking-bundle ``` Requires **Contao ^5.3** and **PHP ^8.2**. Features -------- [](#features) - Create and manage resources and their availability - Create custom forms in the form generator to book resources and collect arbitrary data from input fields; whatever is needed in your project - Display a calendar with bookings and available resources - Create custom calendar templates to display resources and bookings however you like - Optional double opt-in booking process included (using Contao's built-in opt-in mechanism) - Handle bookings in the backend, e.g., to approve or reject them - Send notifications for bookings and cancellations - Book resources for specific time slots (not fully implemented yet) - Full [notification center](https://github.com/terminal42/contao-notification_center) support with custom notification types Usage ----- [](#usage) ### Opt-In to Booking Requests [](#opt-in-to-booking-requests) To require double opt-in on booking requests, check the respective option on the resource booking archive in the backend and select your desired notification. In the notification's body, place a link to a page that handles the opt-in. To the link, append a query parameter `?rb-token=##token##` where `##token##` is the token generated by the bundle. > In the future, we may provide a dedicated opt-in link token, so that you can select the opt-in page directly from the backend. On the opt-in page, include the provided opt-in content element to handle the opt-in process. On this page, you can also show your custom confirmation message. Developers ---------- [](#developers) You can create your custom booking archive types, which handle the display of booking resources and calendars within the booking form. Note As of now, time-slot logic is limited to whole days. In the future, the booking archive types will be able to handle time-slots of arbitrary length customizable down to individual days of the week. ### Setting up Custom Calendars [](#setting-up-custom-calendars) If you extend your custom archive type class from the abstract base class, you are most likely already setup and ready to create a custom template. ``` use HeimrichHannot\ResourceBookingBundle\Booking\ArchiveType\AbstractArchiveType; class MyCustomArchiveType extends AbstractArchiveType { } ``` If you do not override the `getTemplate()` method, the bundle will infer the template name from the class name, i.e., `resource_booking/calendar/my_custom.html.twig`. #### Calendar Template Logic [](#calendar-template-logic) We recommend that you extend your custom `resource_booking/calendar` templates from the provided base template, as shown in the example below. It is crucial to understand, that within the calendar template, *you* are responsible for rendering interactive booking resources and time slots. - You are provided with some template variables that you can use to render the resources and time slots. - You may also use the provided API to fetch the booking resources and time slots with JavaScript. You SHOULD use the provided JavaScript module to select resources and set the respective time slot. ``` {% extends '@Contao/resource_booking/calendar.html.twig' %} {# add custom attributes to the calendar root element (mount) #} {% do attributes.mergeWith({'data-my-attr': 'whatever'}) %} {% block mount %} {# @var booking_archive \HeimrichHannot\ResourceBookingBundle\Model\BookingArchiveModel #} {# @var resource_archives \HeimrichHannot\ResourceBookingBundle\Model\ResourceArchiveModel[] #} {# @var resources \HeimrichHannot\ResourceBookingBundle\Model\ResourceModel[] #} Either render your custom calendar here using the provided template variables, or use the provided JavaScript module to fetch the resources and time slots programmatically to render them via JavaScript. Of course, you may also choose a hybrid approach, rendering some components via JavaScript and others via Twig. {% endblock %} {% block script %} {# Use an ES module to handle the booking form logic #} import { bookingForms } from '@huh/rb'; // ready to use API // bind the booking form to automatically handle // the resource and time slot data on form submit const bookingForm = bookingForms.find('{{ mount_id }}'); if (!bookingForm) throw new Error('Booking form not found'); bookingForm.bind(); // fetch resources and bookings programmatically (optional) const resourceResult = await bookingForm.fetchResources(); if (!resourceResult) throw new Error('Failed to fetch resources'); const resources = resourceResult.resources || []; const resourceArchives = resourceResult.archives || []; const bookingsResult = await bookingForm.fetchBookings(); if (!bookingsResult) throw new Error('Failed to fetch bookings'); const bookings = bookingsResult.bookings || []; /* *Booking Form Logic* * * - access the parent element of the mount block above with * `bookingForm.$mount` * - render resources and time slots, e.g., a calendar * - set the selected resources and time slot programmatically * - using `bookingForm.data` handles submission and validation * of the booking data automatically, * if `bookingForm.bind()` was called */ // set the start and end date for the desired booking period bookingForm.data.start = new Date('2026-01-01'); bookingForm.data.end = new Date('2026-02-02'); // use a resource with id and set the quantity bookingForm.data.useResource(resources[0].id, 2); bookingForm.isLoading = false; // disable/enable a loading indicator on the form {% endblock %} ``` Contributing ------------ [](#contributing) ### Building the JS Bundle [](#building-the-js-bundle) This Contao bundle uses Vite to build the JS modules. Run the following command to build the minified production assets: ``` npm run build ``` With the following command, the bundle will be built in development mode: ``` npm run dev ``` To watch for changes and rebuild the bundle automatically in development mode, run: ``` npm run watch ``` ### Using bundle assets in twig [](#using-bundle-assets-in-twig) This bundle provides a manifest file for configuration with the `symfony/asset` component. Use `huh_rb_build` (for Vite-bundled assets) or `huh_rb` (for public bundle files) as the bundle name to reference the assets in your twig templates. ``` ``` ### Health Score 36 — LowBetter than 79% of packages Maintenance75 Regular maintenance activity Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 6 Last Release 136d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/28ad3224d8727b622ebd229840eea6b9dbcb83eb0bd609e6ce65b614830ff538?d=identicon)[digitales@heimrich-hannot.de](/maintainers/digitales@heimrich-hannot.de) --- Top Contributors [![ericges](https://avatars.githubusercontent.com/u/25957923?v=4)](https://github.com/ericges "ericges (51 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/heimrichhannot-contao-resource-booking-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/heimrichhannot-contao-resource-booking-bundle/health.svg)](https://phpackages.com/packages/heimrichhannot-contao-resource-booking-bundle) ``` ### Alternatives [easycorp/easyadmin-bundle Admin generator for Symfony applications 4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 585.6M577](/packages/shopware-core)[metamodels/core MetaModels core 10156.4k68](/packages/metamodels-core)[shopware/platform The Shopware e-commerce core 3.4k1.5M3](/packages/shopware-platform)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.4M204](/packages/sulu-sulu)[oro/platform Business Application Platform (BAP) 645143.5k115](/packages/oro-platform) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)