Developing Distributions with Panopoly

Last updated April 25, 2013. Created by populist on June 21, 2012.
Edited by barraponto, stevepurkiss, esmerel, nedjo. Log in to edit this page.

Panopoly is designed to be used as a "base distribution" for other distributions to leverage to quickly build awesome Drupal distributions full of all the magic Panopoly has to offer! In order to take advantage of Panopoly as a base distribution, you need to do the following things:

Include Panopoly's Modules & Libraries In Your Distribution

Panopoly requires several contributed modules and external libraries to function correctly, often with specific patches necessary to make everything work together magically. These modules and libraries must be installed as part of your distribution in order to use the power of Panopoly. In order to do this, add the following lines to your profile's make file:

This will automatically package all of the Panopoly specific modules and dependent modules and libraries through some drush make magic. You will also need to enable them as part of your installation profile which can be done by adding the following to your profile's info file:

Enable Support for Panopoly's Special Install Task

Panopoly improves the dependency checking of the core installer which helps simplify sub-profiles. In order to get both of these working in your install profile, you need to include the following code to your profile's hook_install_tasks_alter().

Enable Support for Panopoly's Apps (Optional)

Panopoly leverages the Apps module to enable the many apps that create magic with Panopoly. In order to get this working in your install profile, you need to include the following code to your profile's hook_install_tasks().

Enhance Distribution Functionality with Panopoly Development Patterns

Once you have the required Panopoly apps installing and your distribution based on Panopoly, it is important to enhance your existing distribution to take advantage of Panopoly development patterns (i.e. switch to using Panopoly's responsive layouts, convert blocks to panel panes) which are outlined in the documentation on developing sites with Panopoly.