Skip to content
Go to file
Cannot retrieve contributors at this time
136 lines (101 sloc) 4.97 KB


  1. Fork the repo and apply your changes in a feature branch.
  2. Issue a pull request.

Getting Started

  1. Fork Zookeeper Online

  2. Clone Zookeeper from your fork

  3. Create and check out a new branch for your feature or enhancement

  4. Copy config/config.example.php to config/config.php and edit as appropriate

  5. Apply and test your changes. Please keep the source code style as consistent as possible with the existing codebase. Zookeeper Online uses the PSR-2 coding style with a couple of exceptions:

    • Opening braces for classes go on the SAME line.
    • Opening braces for methods go on the SAME line.
  6. Push your changes to your branch at github.

  7. Create a pull request


Zookeeper follows the MVC (Model-View-Controller) pattern. There are clear architectural boundaries between the busienss logic (in engine) and the presentation, which is contained in ui and controllers.

The following is an overview of the source code directory structure:

             This is the main configuration file.  It includes
             settings for the database, SSO setup (if any),
             e-mail, hyperlinks, branding, etc.
             Model configuration.  This maps the model interfaces
             onto the concrete implementations.
             Controller and navigation configuration.  Controller
             configuration maps request targets onto controllers;
             navigation configuration defines menu items, access
             controls, and implementations.
        Controllers are responsible for processing requests
        that are received by the application.  Controllers are
        instantiated and invoked by the Dispatcher, whose
        operation is specified via metadata in
        CSS files

        Instance-specific customizations that you wish to keep
        separate from the standard installation.  For example,
        if you have custom controllers, you can put them here.
        Business operations, configuration, and session
        Business operations are defined by interfaces.
        Each interface represents a logic grouping of
        operations.  The pattern is to call Engine::api
        for the interface you want to use.  Engine::api is
        a factory which instantiates a concrete
        implementation for a given interface.  You can
        then invoke the methods on the object instance returned
        by Engine::api.  The interface to concrete implementation
        bindings are metadata driven, via config/engine_config.php.

        The Engine::api interfaces are:
          • IChart - rotation and charting
          • IDJ - DJ airname management
          • IEditor - music library management
          • ILibrary - music library search
          • IPlaylist - DJ playlist operations
          • IUser - user management

        Session state is application-managed; access the
        current session state through the singleton
        Configuration file data is accessible through
        various methods on the Engine class.
        Concrete implementations of the business operations.
        Classes in this directory should never be referenced
        nor accessed directly; all access should be mediated
        through the respective interfaces.  See 'engine',
        above, for a discussion of the Engine::api pattern.
        image files
        JavaScript files
        UI rendering.  Menu items and their mappings are specified
        in metadata, via config/ui_config.php.

        Third-party dependencies.
        main endpoint for the application
        maps virtual endpoints onto index.php.  This file also
        contains PHP settings when run via a webserver module.

        PHP settings when run via fastCGI


As you contribute code, please observe the following guidelines:

  • Code in engine may never reference other parts of the application;
  • All access to the engine is mediated via the Engine::api pattern (see above for a discussion);
  • Code outside the engine must delegate all database access to the engine.

Questions, comments, queries, or suggestions are welcome.

Thank you for contributing to Zookeeper Online!

You can’t perform that action at this time.