PHPackages                             openeuropa/oe\_agenda - 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. [API Development](/categories/api)
4. /
5. openeuropa/oe\_agenda

ActiveDrupal-module[API Development](/categories/api)

openeuropa/oe\_agenda
=====================

OpenEuropa Drupal module that exposes an agenda.

1.x-dev(3mo ago)04.8k↓80.6%1EUPL-1.2PHPPHP &gt;=8.1CI passing

Since Mar 20Pushed 3mo ago12 watchersCompare

[ Source](https://github.com/openeuropa/oe_agenda)[ Packagist](https://packagist.org/packages/openeuropa/oe_agenda)[ RSS](/packages/openeuropa-oe-agenda/feed)WikiDiscussions 1.x Synced 2d ago

READMEChangelog (5)Dependencies (13)Versions (11)Used By (1)

OpenEuropa Agenda
=================

[](#openeuropa-agenda)

Drupal module that exposes an agenda. The module defines the Agenda, Day, and Session sub-entity types and their default bundles.

**Table of contents:**+

- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Development setup](#development-setup)
- [Contributing](#contributing)
- [Versioning](#versioning)

Requirements
------------

[](#requirements)

Depends on the following software:

- [PHP &gt;=8.1](http://php.net/)
- Virtuoso (or equivalent) triple store

Installation
------------

[](#installation)

Install the package and its dependencies:

```
composer require openeuropa/oe_agenda
```

It is strongly recommended to use the provisioned Docker image for Virtuoso. To do this, add the image to your `docker.compose.yml` file:

```
  sparql:
    image: openeuropa/triple-store-dev
    environment:
    - SPARQL_UPDATE=true
    - DBA_PASSWORD=dba
    ports:
      - "8890:8890"

```

Otherwise, make sure you have the triple store instance running.

Next, if you are using the Task Runner to set up your site, add the `runner.yml` configuration for connecting to the triple store. Under the `drupal` key:

```
  sparql:
    host: "sparql"
    port: "8890"

```

Still in the `runner.yml`, add the instruction to create the Drupal settings for connecting to the triple store. Under the `drupal.settings.databases` key:

```
  sparql_default:
    default:
      prefix: ""
      host: ${drupal.sparql.host}
      port: ${drupal.sparql.port}
      namespace: 'Drupal\Driver\Database\sparql'
      driver: 'sparql'

```

Then you can proceed with the regular Task Runner commands for setting up the site.

Otherwise, ensure that in your site's `setting.php` file you have the connection information to your own triple store instance:

```
$databases["sparql_default"] = array(
  'default' => array(
    'prefix' => '',
    'host' => 'your-triple-store-host',
    'port' => '8890',
    'namespace' => 'Drupal\\Driver\\Database\\sparql',
    'driver' => 'sparql'
  )
);

```

Usage
-----

[](#usage)

To enable the module, run:

```
drush en oe_agenda
```

### Default session type Moderators and Speakers fields

[](#default-session-type-moderators-and-speakers-fields)

These fields are configured to reference Person reference entities (defined by the `oe_content_sub_entity_person` submodule of [OE Content](https://github.com/openeuropa/oe_content)). There are no target bundles selected for these fields after installation. To make the fields work, you need to create and configure one or more Person sub-entity types (*Structure &gt; Person types &gt; Add Person type*). Then you need to select the target bundle(s) for the fields on the following admin pages and save the field settings:

```
/admin/structure/oe_agenda_session_type/oe_default/edit/fields/oe_agenda_session.oe_default.oe_session_moderators
/admin/structure/oe_agenda_session_type/oe_default/edit/fields/oe_agenda_session.oe_default.oe_session_speakers

```

Development setup
-----------------

[](#development-setup)

### Requirements

[](#requirements-1)

- [Virtuoso 7 (Triplestore database)](https://github.com/openlink/virtuoso-opensource)

### Initial setup

[](#initial-setup)

You can build the test site by running the following steps.

- Install Virtuoso. The easiest way to do this is by using the OpenEuropa [Triple store](https://github.com/openeuropa/triple-store-dev) development Docker container which also pre-imports the main Europa vocabularies.
- Install all the composer dependencies:

```
composer install
```

- Customize build settings by copying `runner.yml.dist` to `runner.yml` and changing relevant values, like your database credentials.

This will also symlink the module in the proper directory within the test site.

- Install test site by running:

```
./vendor/bin/run drupal:site-install
```

Your test site will be available at `./build`.

**Please note:** project files and directories are symlinked within the test site by using the [OpenEuropa Task Runner's Drupal project symlink](https://github.com/openeuropa/task-runner-drupal-project-symlink) command.

If you add a new file or directory in the root of the project, you need to re-run `drupal:site-setup` in order to make sure they are be correctly symlinked.

If you don't want to re-run a full site setup for that, you can simply run:

```
$ ./vendor/bin/run drupal:symlink-project

```

### Using Docker Compose

[](#using-docker-compose)

Alternatively, you can build a development site using [Docker](https://www.docker.com/get-docker) and [Docker Compose](https://docs.docker.com/compose/) with the provided configuration.

Docker provides the necessary services and tools such as a web server and a database server to get the site running, regardless of your local host configuration.

#### Requirements:

[](#requirements-2)

- [Docker](https://www.docker.com/get-docker)
- [Docker Compose](https://docs.docker.com/compose/)

#### Configuration

[](#configuration)

By default, Docker Compose reads two files, a `docker-compose.yml` and an optional `docker-compose.override.yml` file. By convention, the `docker-compose.yml` contains your base configuration, and it's provided by default. The override file, as its name implies, can contain configuration overrides for existing services or entirely new services. If a service is defined in both files, Docker Compose merges the configurations.

Find more information on Docker Compose extension mechanism on [the official Docker Compose documentation](https://docs.docker.com/compose/extends/).

#### Usage

[](#usage-1)

To start, run:

```
docker-compose up
```

It's advised to not daemonize `docker-compose` so you can turn it off (`CTRL+C`) quickly when you're done working. However, if you'd like to daemonize it, you have to add the flag `-d`:

```
docker-compose up -d
```

Then:

```
docker-compose exec web composer install
docker-compose exec web ./vendor/bin/run drupal:site-install
```

Using default configuration, the development site files should be available in the `build` directory and the development site should be available at: .

#### Running the tests

[](#running-the-tests)

To run the grumphp checks:

```
docker-compose exec web ./vendor/bin/grumphp run
```

To run the phpunit tests:

```
docker-compose exec web ./vendor/bin/phpunit
```

#### Step debugging

[](#step-debugging)

To enable step debugging from the command line, pass the `XDEBUG_SESSION` environment variable with any value to the container:

```
docker-compose exec -e XDEBUG_SESSION=1 web
```

Please note that, starting from XDebug 3, a connection error message will be outputted in the console if the variable is set but your client is not listening for debugging connections. The error message will cause false negatives for PHPUnit tests.

To initiate step debugging from the browser, set the correct cookie using a browser extension or a bookmarklet like the ones generated at .

Contributing
------------

[](#contributing)

Please read [the full documentation](https://github.com/openeuropa/openeuropa) for details on our code of conduct, and the process for submitting pull requests to us.

Versioning
----------

[](#versioning)

We use [SemVer](http://semver.org/) for versioning. For the available versions, see the [tags on this repository](https://github.com/openeuropa/oe_content/tags).

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance80

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 63.2% 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 ~145 days

Recently: every ~172 days

Total

6

Last Release

107d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d3b1f4079f9a82f6dd88fe6577d1256b4ecbbccbcd4a4ec9bea7c2fd6f72b99a?d=identicon)[DIGIT-CORE](/maintainers/DIGIT-CORE)

---

Top Contributors

[![kp77](https://avatars.githubusercontent.com/u/648045?v=4)](https://github.com/kp77 "kp77 (84 commits)")[![brummbar](https://avatars.githubusercontent.com/u/8488617?v=4)](https://github.com/brummbar "brummbar (15 commits)")[![drishu](https://avatars.githubusercontent.com/u/11507647?v=4)](https://github.com/drishu "drishu (14 commits)")[![donquixote](https://avatars.githubusercontent.com/u/150032?v=4)](https://github.com/donquixote "donquixote (11 commits)")[![tibi2303](https://avatars.githubusercontent.com/u/36895476?v=4)](https://github.com/tibi2303 "tibi2303 (4 commits)")[![vengador](https://avatars.githubusercontent.com/u/433632?v=4)](https://github.com/vengador "vengador (2 commits)")[![AaronGilMartinez](https://avatars.githubusercontent.com/u/7264392?v=4)](https://github.com/AaronGilMartinez "AaronGilMartinez (2 commits)")[![piotrsmykaj](https://avatars.githubusercontent.com/u/10449853?v=4)](https://github.com/piotrsmykaj "piotrsmykaj (1 commits)")

### Embed Badge

![Health badge](/badges/openeuropa-oe-agenda/health.svg)

```
[![Health](https://phpackages.com/badges/openeuropa-oe-agenda/health.svg)](https://phpackages.com/packages/openeuropa-oe-agenda)
```

###  Alternatives

[farmos/farmos

A web-based farm record keeping application.

1.3k7.1k1](/packages/farmos-farmos)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6942.5M421](/packages/drupal-core-recommended)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
