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

• Download and complete the installation for October CMS (http://octobercms.com)
• 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.

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.

• Download the makefile in this repository installer/Makefile (e.g. curl -O https://raw.githubusercontent.com/artsmia/OctoberFriends/master/installer/Makefile)
• Uncomment and set the lines for your Github username and the OctoberCMS database details.
• Run make install in your chosen install directory.

Developing custom activity types

Using custom events

PHP API Documentation is available at http://developer.dma.org/friends/

OctoberCMS Documentation is available at https://octobercms.com/docs/

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