Drupal Opening Hours module

Drupal 9.4+ module that integrates the Opening Hours platform functionality.

This module allows to consume the Opening Hours Platform API to lookup services, their channels and their opening hours data.

Install

Install using composer:

Add the git source to the composer by editing the composer.json in the project root and add following lines in the `repositories section:

    "repman-digipolis": {
        "type": "composer",
        "url": "https://digipolis.repo.repman.io"
    },
    "digipolis-gent/opening-hours-widget": {
        "type": "package",
        "package": {
            "name": "drupal/opening-hours-widget",
            "type": "drupal-library",
            "version": "0.1.1",
            "dist": {
                "type": "zip",
                "url": "https://github.com/StadGent/npm_package_opening-hours-widget/releases/download/0.1.1/opening-hours-widget.zip"
            }
        }
    }

Install the module using composer:

composer require drupal/opening_hours

Enable the module:

drush -y en opening_hours

Configure the opening hours module and set the Opening Hours API url via admin/admin/config/services/opening-hours.

Usage

Adding opening hours information to an entity is done by adding an opening hours field.

The opening hours information is loaded via ajax requests to the opening hours backend.

Synchronization

The opening hours information could be changed (service and channel label) or could be removed from the opening hours backend. A drush command is available to synchronization the data and to flag opening hours fields with broken links.

• drush opening-hours:sync all : Synchronize all opening hours fields of all entities where they are used.
• drush opening-hours:sync node_type : Synchonize all opening hours fields of all entities of the provided entity type.
• drush opening-hours:sync node_type:123 : Synchronize all opening hours fields of the provided entity type and entity id.

Broken links will be logged in the log.

There is an event that is triggered if a broken field is detected. See \Drupal\opening_hours\Event\FieldBrokenLinkEvent and \Drupal\opening_hours\EventSubscriber\FieldSubscriber.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please email security [at] gent.be instead of using the issue tracker. See SECURITY

Credits

• Stad Gent
• Digipolis Gent
• All Contributors

License

The MIT License (MIT). Please see [License File][link-license] for more information.

Roadmap and issue queue notes

This project is created and maintained by Digipolis Gent. During active development, we use an internal issue tracker to guide/drive our development. By working this way, we can link issues for other projects dependent on this project, create cross-project boards, ... This allows our developers, project leads and business analysts to have a better overview than we can create on Github. This means that our roadmap won't be visible on here (for now).

We still look at the issue queue here and off course we welcome pull requests with open arms! We are committed to creating and maintaining open source projects. Questions about our approach can be asked through the issue queue (except for security issues).