cultuurnet/culturefeed

CultuurNet culturefeed Drupal module

Wednesday, July 4, 2018
by cyberwolf
Repository
23 Watchers
11 Stars
936 Installations

PHP
0 Dependents
0 Suggesters
15 Forks
9 Open issues
100 Versions
1 % Grown

The README.md

Culturefeed

, _(*1)

Important note

In november 2019, publiq vzw (formerly known as CultuurNet) starts the End of Support phase of the Culturefeed Drupal 7 module suite. This means that you can continue to use Culturefeed, but publiq vzw will not invest anymore in this Drupal 7 module suite., _(*2)

As an exception, critical security updates will still be provided if needed., _(*3)

The End of Life (EOL) date of the module suite is set to the same date as the EOL of Drupal 7 core, ie. November 2021 (https://www.drupal.org/psa-2019-02-25)., _(*4)

We built this final 4.0 release, which contains a major security update, and some incompatible changes compared to the latest 3.10.2 release. Some less used modules are moved to a separate repository. If you update to this version please check & should you use one of these modules, reinstall them from a separate repository. After that all things should work as usual. - https://github.com/cultuurnet/culturefeed_pages [DEPRECATED], _(*5)

https://github.com/cultuurnet/culturefeed_roles [DEPRECATED], _(*6)
https://github.com/cultuurnet/culturefeed_messages [DEPRECATED], _(*7)
https://github.com/cultuurnet/culturefeed_calendar [DEPRECATED], _(*8)
https://github.com/cultuurnet/culturefeed_uitpas, _(*9)
https://github.com/cultuurnet/culturefeed_social, _(*10)
https://github.com/cultuurnet/culturefeed_userpoints_ui [DEPRECATED], _(*11)
https://github.com/cultuurnet/culturefeed_entry_ui [DEPRECATED], _(*12)

Alternatives

As an alternative for the Culturefeed Drupal 7 module suite, publiq vzw focused on:, _(*13)

A new, easy to use API in a developer-friendly Json format: https://projectaanvraag.uitdatabank.be/#!/integrations#api, _(*14)
An even easier to use widget platform: https://projectaanvraag.uitdatabank.be/#!/integrations#widgets, _(*15)

We also have a Drupal 8 version on https://github.com/cultuurnet/culturefeed_d8 with the most commonly used modules culturefeed_agenda, culturefeed_content, culturefeed_search, culturefeed_search_api and culturefeed_user., _(*16)

However, these modules will not contain the full functionality as was provided in the Drupal 7 edition, and it will not be heavily extended by publiq the same way we did this for the Drupal 7 edition. We are still happy to review and accept pull requests from external developers or partners, though., _(*17)

Info

Drupal module suite for building an event site based on events gathered in an external backoffice "outdatabase" (UiTdatabank), but with the extra tools you can do a lot more. For this version you can only use it having a key and secret from the UiTdatabank or use the demo key from this page., _(*18)

Live demo connecting production API only available from 7:00 till 20:00 (Brussels timezone), _(*19)

Live demo connecting acceptance API only available from 7:00 till 20:00 (Brussels timezone), _(*20)

Important note
Since the culturefeed 3.6 release PHP v5.5 is the minimum requirement and also the PHP INTL extension is needed. To install the extension on your system take a look at this blogpost.

Culturefeed-kickstart

When you start with a clean Drupal install or just for setting up a quick demo site we created a __Drupal install profile__ ("Installation profiles provide specific site features and functions for a specific purpose or type of site distributions"). This included also a shell script (Build.sh) which downloads:, _(*21)

drupal core (at the moment 7.56)
drupal contribs (bootstrap 3.0)
culturefeed
culturefeed_bootstrap
vendor/cultuurnet/cdb
vendor/cultuurnet/auth
vendor/cultuurnet/search
vendor/cultuurnet/culturefeed-php
vendor/cultuurnet/calendar-summary
vendor/cultuurnet/sitemap-xml
lessphp

Install

Prerequisites:, _(*22)

php > v5.5 and the php intl extension (see important note above)
git installed
drush installed
composer installed (http://getcomposer.org/doc/00-intro.md#downloading-the-composer-executable)

Place the module suite in your sites/*/modules folder, you can do this with GIT or download it here., _(*23)

git clone https://github.com/cultuurnet/culturefeed

Afterwards copy the composer.json file from the root of the module suite to the root directory of your Drupal. If you use already composer.json you have to add the required libraries., _(*24)

{
    "name": "cultuurnet/culturefeed",
    "type": "drupal-module",
    "description": "CultuurNet culturefeed Drupal module",
    "license": "Apache-2.0",
    "require": {
      "composer/composer": "~1.0",
      "mobiledetect/mobiledetectlib": "dev-master",
      "cultuurnet/search": "~1.2",
      "cultuurnet/cdb": "~2.1",
      "cultuurnet/culturefeed-php": "~1.6",
      "cultuurnet/calendar-summary": "~1.0",
      "cultuurnet/sitemap-xml": "~1.0"
    },
    "require-dev": {
      "phing/phing": "~2.10"
    },
    "minimum-stability": "dev",
    "prefer-stable": true
}

After that run composer install or composer update if already using composer. This will download our libraries and add a theme to a vendor directory. It will also create a composer.lock file. Typical we add vendor/* to the .gitignore file., _(*25)

Last step is to include autoload.php in your settings.php file of your site., _(*26)

require 'vendor/autoload.php';

You should now be able to enable the modules (typically you start with culturefeed, culturefeed_ui, culturefeed_search, culturefeed_search_ui and culturefeed_agenda) and fill in your key and secret:, _(*27)

culturefeed core at admin/config/culturefeed/api-settings
if culturefeed_search enabled also at admin/config/culturefeed/search

It's a good practice to connect your user/1 (admin) user with a UiTID account: - Log in as user/1 - Go to culturefeed/oauth/connect and login to UiTID., _(*28)

If this works culturefeed core is configured well. And if you get results at the path agenda/search culturefeed_search is working as well., _(*29)

Tutorials

We created 3 tutorials to integrate the most common use cases:, _(*30)

PHP libraries

Most of the modules have an dependency on these PHP libraries. See "Install" how to install theme with composer., _(*31)

CultuurNet\Cdb

Fluent PHP library for manipulating, serializing and deserializing data present in CultuurNet's CdbXML 3.2 or 3.3 format, _(*32)

https://github.com/cultuurnet/cdb, _(*33)

CultuurNet\Search

Php library for creating SOLR queries (basic SOLR queries and custom business logic), _(*34)

https://github.com/cultuurnet/Search, _(*35)

CultuurNet\Auth

The consumer-side of the authentication flow of CultuurNet's UiTID, which is based on OAuth 1.0a Core solid base for consumers of various OAuth-protected resources provided by CultuurNet, _(*36)

https://github.com/cultuurnet/Auth , _(*37)

CultuurNet\CultureFeed-PHP

Integration of all UiTID API calls., _(*38)

https://github.com/cultuurnet/culturefeed-php, _(*39)

CultuurNet\calendar-summary

The calendar-summary PHP takes a CultureFeed_Cdb_Data_Calendar object (hence the dependency on cultuurnet/cdb, and formats it. Right now there's a HTML formatter and a plain text formatter. Current options: 'lg' (for permanent events only this option is available), 'md', 'md', 'sm', 'xs'., _(*40)

https://github.com/cultuurnet/calendar-summary, _(*41)

CultuurNet\sitemap-xml-php

PHP library for writing sitemap XML conform with the sitemaps.org schema. Example see http://www.uitinvlaanderen.be/sitemap.xml. Only needed when you turn on the culturefeed_sitemap module., _(*42)

https://github.com/cultuurnet/sitemap-xml-php, _(*43)

Theme

Culturefeed Bootstrap is the only supported and recommended base theme for Culturefeed. It's a responsive subtheme of the Bootstrap Framework and has it's own subtheme to start from. But of course you can implement Culturefeed in your prefered theme as well., _(*44)

https://github.com/cultuurnet/culturefeed_bootstrap, _(*45)

Modules

Please enable only the modules you need., _(*46)

Culturefeed core

Core of the module suite and is required by the other modules. It provides the settings form where you can enter the API Information., _(*47)

More info at wiki page, _(*48)

Culturefeed_search

Base framework to enable searches on your site. Out of the box this module doesn't provide any interface elements (use Culturefeed Search UI and Culturefeed Agenda instead). It provides some drush commands and caching., _(*49)

More info at wiki page, _(*50)

Culturefeed_agenda

Provides a Culturefeed search page available on 'agenda/search' and detail pages. The blocks provided by this module can be used to extend the detail pages of events, actors and productions. Includes also a simple search form., _(*51)

More info at wiki page, _(*52)

Culturefeed_search_ui

Basic elements to build up an event search (such as provided by Culturefeed Agenda)., _(*53)

Basic search form with type selector in the front (can be extended)
Sort block
Active filters
Facets

More info at wiki page, _(*54)

To integrate a search page we also wrote a tutorial., _(*55)

Culturefeed_search_views

Views integration to list events, actors or productions. To create culturefeed views, create a new view and configure it to show Cdb items. Once the view is created, following handlers can be set:, _(*56)

Fields
Filters
Sort

More info at wiki page, _(*57)

Culturefeed_devel

This module logs every query to our API, on the screen for admins or to the watchdog. Handy tool to check which is the performance killer, your Drupal install or our API's., _(*58)

Culturefeed_entry_ui

Functions to do a CRUD on events are already in library, but we are building a form to create, update and delete events in our UiTdatabank as well., _(*59)

More info at wiki page, _(*60)

Culturefeed_pages

User can create a page (locations, performers, families, schools, …) or become member and follower., _(*61)

Wiki page not yet available, _(*62)

Culturefeed_ui

Provides a collection of pages and blocks to enhance the user pages with UiTID information. To do this it will override and/or enhance the default Drupal user pages. Some features:, _(*63)

edit profile page
edit account page
search users page
caching
teaser (formerly connect)
most active user
login (formerly profile box)
profile menu
e-mail confirmation reminder
search users
profile summary (formerly My UiTiD)

More info at wiki page, _(*64)

To integrate UiTID we also wrote a tutorial., _(*65)

Culturefeed_social

All ‘social’ features: likes, comments, attends, etc., _(*66)

More info at wiki page, _(*67)

Culturefeed_uitpas

Integration with the UiTPAS card system. It contains multiple pages and blocks that can be used to build an interface that allows:, _(*68)

easy access to the advantages and promotions a passholder has access to,
possibility to register your UiTPAS,
highlights of promotions and actions.

More info at wiki page, _(*69)

To integrate UiTPAS we wrote a tutorial., _(*70)

Culturefeed_mailing

To create mailings with search results from event (based on lifestyleprofile, Vlieg weekendflash, …). Not yet available for partners. Please contact us if interested., _(*71)

Culturefeed_messages

Send messages to other users (most likely page owners), interesting when actors become pages., _(*72)

Culturefeed_userpoints_ui

Collect on line userpoints (for specific actions like writing reviews) and claim promotions (Vlieg). Not yet available for partners. Please contact us if interested., _(*73)

Culturefeed_roles

Pre-assign roles to UiTID users that have not logged in yet. Drush integration., _(*74)

Culturefeed_calendar

UiTkalender functionality not yet released on UiTinVlaanderen (some extra features are going to be added in next release), _(*75)

Culturefeed_content

Adds a CultureFeed content field to add a search query to any of your content types., _(*76)

Culturefeed_saved_searches

With this functionality your user can save a search and create alerts from it., _(*77)

Culturefeed_sitemap

Creates a sitemap for events, productions and actors, see example http://www.uitinvlaanderen.be/sitemap.xml., _(*78)

Examples

There already a lot of integrations live on the 3.x version (and still counting):, _(*79)

http://www.uitinvlaanderen.be
http://www.uitinmechelen.be
http://www.uitinsint-niklaas.be
http://www.2014-18.be
http://agenda.hbvl.be
http://agenda.gva.be
https://www.uitpas.be
https://www.muntpunt.be/agenda/search
http://www.starttoswim.com
http://www.cultuurkuur.be
http://www.uitmetvlieg.be
http://agenda.besteburen.eu

License

Apache-2.0, _(*80)

The Versions

04/07 2018

dev-feature/UIV-2124

CultuurNet culturefeed Drupal module

drupal-module culturefeed

CultuurNet culturefeed Drupal module

cultuurnet/culturefeed

The README.md

Culturefeed

Important note

Alternatives

Info

Culturefeed-kickstart

Install

Tutorials

PHP libraries

CultuurNet\Cdb

CultuurNet\Search

CultuurNet\Auth

CultuurNet\CultureFeed-PHP

CultuurNet\calendar-summary

CultuurNet\sitemap-xml-php

Theme

Modules

Culturefeed core

Culturefeed_search

Culturefeed_agenda

Culturefeed_search_ui

Culturefeed_search_views

Culturefeed_devel

Culturefeed_entry_ui

Culturefeed_pages

Culturefeed_ui

Culturefeed_social

Culturefeed_uitpas

Culturefeed_mailing

Culturefeed_messages

Culturefeed_userpoints_ui

Culturefeed_roles

Culturefeed_calendar

Culturefeed_content

Culturefeed_saved_searches

Culturefeed_sitemap

Examples

License

The Versions

dev-feature/UIV-2124

The Requires

The Development Requires

dev-feature/UIV-2048

The Requires

The Development Requires

dev-develop

The Requires

The Development Requires

dev-feature/WKS-351

The Requires

The Development Requires

dev-feature/CF-510

The Requires

The Development Requires

dev-feature/UIV-freeze

The Requires

The Development Requires

dev-feature/BVV-1381

The Requires

The Development Requires

dev-master

The Requires

The Development Requires

dev-feature/CK-93

The Requires

The Development Requires

dev-hotfix/PWK-654

The Requires

The Development Requires

dev-feature/CK-113

The Requires

The Development Requires

dev-feature/UIV-2116

The Requires

The Development Requires

dev-feature/WKS-317

The Requires