Skip to content
Go to file
This branch is 3 commits ahead, 10 commits behind DallasMuseumArt:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

DMA Friends

DMA Friends is an open source plugin for October CMS that encourages and recognizes visitor participation as an essential ingredient of the museum experience.

Installation (manual)

  • Download and complete the installation for October CMS (
  • Install the Rainlab "User" Plugin
  • Extract this repository into plugins/dma/friends
  • In plugins/dma/friends folder run composer install.
  • Then run: php artisan october:up.
  • Go to the Friends Theme Repository for instructions on downloading and installing the companion theme.

Installing Rainlab plugin:

Log into to the OctoberCMS backend (default http://HOSTNAME/backend) site. Click Settings. Select System / Updates from the left menu. Type rainlab.user and click Install Plugin on this page.

Installation via Makefile


The DMA Friends pluging also provide a REST API to allow build custom applications that can interact with the platform, for futher information about all available endpoints can be found at plugins/dma/friends/docs/api-docs folder.


Since version 2.6.1 the REST API requires pass an autentication token in almost all available endpoints of the API. For that reason it is required to follow the below steps to configure the REST API.

  • Create a config.php file for the Friends pluging at <octobercms root>/config/dma/friends/.
    Note: If folder structure don't exist create is manually

  • Add to the config.php file a secret key that is used to sign and authenticated all calls to the API. The config.php file show look like the below example.


return [


Developing custom activity types

Using custom events

PHP API Documentation is available at

OctoberCMS Documentation is available at

(LEGACY) Wordpress Migrations

If you are migrating from a wordpress/badgeos installation of friends you will also need to provide database configuration in order to migrate your data

  • edit apps/config/database.php and add the following
        'friends_wordpress' => array(
            'driver'    => 'mysql',
            'host'      => 'localhost',
            'port'      => '', 
            'database'  => 'WORDPRESS_FRIENDS_DB',
            'username'  => 'WORDPRESS_USER',
            'password'  => 'WORDPRESS_PASS',
            'charset'   => 'utf8',
            'collation' => 'utf8_unicode_ci',
            'prefix'    => '', 

Substituting the appropriate database, user, and password


An OctoberCMS implementation of friends



You can’t perform that action at this time.