Last updated July 24, 2012. Created on September 20, 2011.
Edited by nedjo. Log in to edit this page.

One of the main aims of Debut is to make it easy to build cohesive and feature-rich Drupal distributions.

The quick version

To integrate one or more Debut features into your distribution is quick and easy.

  • Add the Apps module to your install profile's dependencies in the .info file and (if you're using one) .make file.
  • In your .profile file (or an include file), include implementations of hook_apps_servers_info() and hook_install_tasks() . Here are examples adapted from openoutreach.install.inc:
    <?php
    /**
     * Implements hook_apps_servers_info().
     */
    function openoutreach_apps_servers_info() {
     
    $profile = variable_get('install_profile', 'standard');
     
    $info drupal_parse_info_file(drupal_get_path('profile', $profile) . '/' . $profile . '.info');
      return array(
       
    'debut' => array(
         
    'title' => 'debut',
         
    'description' => t('Debut apps'),
         
    'manifest' => 'http://appserver.openoutreach.org/app/query',
         
    'profile' => $profile,
         
    'profile_version' => isset($info['version']) ? $info['version'] : '7.x-1.x',
         
    'server_name' => $_SERVER['SERVER_NAME'],
         
    'server_ip' => $_SERVER['SERVER_ADDR'],
        ),
      );
    }

    /**
     * Generate an install task to install apps.
     */
    function openoutreach_install_tasks($install_state) {
     
    // Kick off the tasks.
     
    $tasks = array();
     
    // Set up the openoutreach Apps install task.
     
    $debut_server = array(
       
    'machine name' => 'debut',
       
    'default apps' => array(
         
    'debut',
         
    'debut_article',
         
    'debut_bio',
         
    'debut_blog',
         
    'debut_comment',
         
    'debut_event',
         
    'debut_highlighted',
         
    'debut_link',
         
    'debut_media',
         
    'debut_section',
         
    'debut_seo',
         
    'debut_social',
         
    'debut_wysiwyg',
        ),
       
    'required apps' => array(
         
    'debut',
        ),
      );
     
    $tasks = $tasks + apps_profile_install_tasks($install_state, $debut_server);

      return
    $tasks;
    }
    ?>

It's also possible to add Debut features directly via including them in your distro's .make file. Unfortunately, the drupal.org packaging code doesn't yet support includes in .make files. See this issue: #1427752: Support drush make includes[] in drupal-org.make files. To do so:

  1. First, edit your distribution's .make file to include the Debut feature's .make.inc file. This means adding a single line to your .make file. For current examples, see the Open Outreach .make file. The next time you build your distro, you'll get the Debut feature and all its dependencies.
  2. Edit your distribution's .info file to add the dependency on the Debut feature.

Extras

Not everything is covered off in Debut. You'll also want to have some basic setup--selecting an admin theme, enabling a few blocks, and so on. You could look at the Open Outreach install profile for ideas here. In fact, you could start by cloning that install profile and adapting from there.

Looking for support? Visit the Drupal.org forums, or join #drupal-support in IRC.