Home › MySite API › Files

Version

1.7.2.3 (checked in on 2008/03/30 at 20:42:13 by agentken)

Description

// $Id: README.txt,v 1.7.2.3 2008/03/30 20:42:13 agentken Exp $

/**

  • @file
  • README file for Domain Conf
*/

Domain Access: Site Configuration Advanced site configuration options for Domain Access.

CONTENTS --------

1. Introduction 1.1 Use-Case 1.2 Example 1.3 Sponsors 2. Installation 2.1 Dependencies 2.2 Configuration Options 3. Batch Updates 4. Developer Notes 4.1 Extending Options with hook_domainconf() 4.2 Using domain_conf.inc 4.3 Database Schema

---- 1. Introduction

The Domain Access: Site Configuration module (called Domain Conf), is an optional extension of the Domain Access module. Domain Conf provides options for configuring basic settings of your affiliate sites to be different.

---- 1.1 Use-Case

In the original build for the Domain Access module, we had a problem. Most of our affiliates were on the East coast of the U.S. But a few were further West, in different time zones.

Using a single time zone configuration for all affiliates simply would not work. So the Domain Conf module was written as an optional extension for Domain Access.

This module allows each affiliate site to set specific configuration options, which will override the default site settings as needed. See section 2.2 for more details.

---- 1.2 Example

For an example, see http://skirt.com/map. Note that some of the affiliates may be in "offline" mode. This is accomplished using the Domain Conf module.

---- 1.3 Sponsors

Domain Conf is sponsored by Morris DigitalWorks. http://morrisdigitalworks.com

---- 2. Installation

The Domain Conf module is included in the Domain Access download. To install, untar the domain package and place the entire folder in your modules directory.

When you enable the module, it will create a {domain_conf} table in your Drupal database.

For the module to function correctly, you must follow the instructions in INSTALL.txt.

---- 2.1 Dependencies

Domain Conf requires the Domain Access module be installed and active.

Domain Conf requires a change to your settings.php file, as indicated by the directions in INSTALL.txt

---- 2.2 Configuration Options

When active, the Domain Conf module provides a 'settings' link next to each entry in your Domain Acccess list (found at path 'admin/build/domain/list').

For each registered domain, you have the option of saving settings that will replace the system settings for your root site. The currently available settings are:

  • Name [of site]
  • E-mail address
  • Slogan
  • Mission
  • Footer message
  • Default front page [untested]
  • Anonymous user
  • Default time zone
  • Site status
  • Site off-line message
On page load, these values are dynamically loaded to replace your site's defaults. If you do not adjust these settings, defaults will be used for all affiliates.

---- 3. Batch Updates

Domain Conf allows you to make batch changes to settings for all domains.

All of the current settings are available in batch mode.

You may also choose to remove domain-specific configurations. This feature is useful if you wish to roll back custom changes.

---- 4. Developer Notes

The Domain Conf module is the model for extending Domain Acccess.

The following form elements were removed during beta testing:

  • File system path
  • Temporary directory
See http://drupal.org/node/197692 for the reasons.

---- 4.1 Extending Options with hook_domainconf()

The module works by applying hook_form_alter() to the form: 'system_settings_form' and then adding addiitonal fields from other forms.

hook_domainconf() allows developers to add additional form elements.

Note that you may use this hook to create variables that are independent of other Drupal modules. To do so, be sure to set the '#domain_setting' flag to TRUE before returning your $form array.

  • $form['myform']['#domain_setting'] = TRUE;
Please see the full documentation in the API.

http://therickards.com/api/function/hook_domainconf/Domain

---- 4.2 Using domain_conf.inc

The normal method for using hook_domainconf() is to have the hook implemented in other modules.

However, the community development process may mean that it will take time for the hook to be implemented in modules that you may be using.

To allow for this fact without harming the upgrade path for Domain Configuration, it is possible to create a domain_conf.inc file that you place inside the domain_conf directory.

This file should be a PHP file, and it should conform to Drupal coding standards.

For example, to add the user picture default setting to the module without patching user.module or domain_conf.module, you may create the following file:

==== <?php /**

*/ function user_domainconf($domain) { $form['pictures'] = array( '#type' => 'fieldset', '#title' => t('User picture'), '#collapsible' => TRUE, '#collapsed' => FALSE, ); $form['pictures']['user_picture_default'] = array( '#type' => 'textfield', '#title' => t('Default picture'), '#default_value' => variable_get('user_picture_default', ''), '#size' => 30, '#maxlength' => 255, '#description' => t('URL of picture to display for users with no custom picture selected. Leave blank for none.') ); return $form; } ====

NOTE: Before upgrading the Domain module, be sure to save this file so that it may be replaced in the event it is deleted. Note also that the domain_conf.inc file is not included in the module package.

See http://drupal.org/node/236877 for additional background.

---- 4.3 Database Schema

Installing the module creates a {domain_conf} table that contains:

  • domain_id
Integer, unique The lookup key for this record, foreign key to the {domain} table.

  • settings
Blob (bytea) A serialized array of settings for this domain.