Skip to content

chrisvidal/OctoberFriends

 
 

Repository files navigation

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 (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.

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

REST API

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.

Enable REST API

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.

<?php

return [
    'secret' => 'PLACE-HERE-A-NICE-LONG-SECRET-KEY'
];

Documentation

Developing custom activity types

Using custom events

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

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

(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

About

An OctoberCMS implementation of friends

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 42.9%
  • JavaScript 41.2%
  • HTML 15.2%
  • Other 0.7%