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

/**
 * @file
 * README file for Domain Source.
 */

Domain Source
Creates a source domain for linking to content from other domains.

CONTENTS
--------

1.  Introduction
1.1  Sponsos
2.  Installation
2.1   Dependencies
2.2   Warning
3.  Module Behavior
3.1   Inherited Permissions
3.2   Content Editing Forms
3.3   Integration with Domain Content
4.  Developer Notes
4.1   Database Schema

----
1.  Introduction

The Domain Source module is a small module that extends Domain Access
by allowing site and affilaite editors to select a primary "source" domain for
all content.

When links are written to content from another domain using the SEO strict
rules, cross-domain sesarching or the "Special Page Requests" rules, the links
will go to the "source" domain specified for the node.

----
1.1  Sponsors

The Domain Source module is sponsored by Dzone, the developer's network.

  http://www.dzone.com

----
2. Installation

This section is not finished.  It requires http://drupal.org/node/210248.

----
2.1 Dependencies

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

----
2.2 Warning

When this module is enabled, existing content is not automatically assigned
to a source domain.

You must either edit the nodes individually or use the Domain Content
module to perform batch edits.

----
3.  Module Behaviors

The Domain Source module alters the core Domain Access module in a few
subtle ways.  It is only used in the following instances:

  -- You wish to allow searching of all domains from any domain.
  -- You use a content aggregation module such as MySite.
  -- You get "access denied" errors when linking to items on a
      user's Track page.
  -- You want to turn on the advanced setting "Search Engine
      Optimization" to avoid content from being indexed on multiple
      domains.

The default Domain Access behavior in these instances is to rewrite links
to point to the first accessible domain.  With the Domain Source module,
editors with the proper permissions can specify which domain should be
considered "authoritative" for a specific piece of content.

----
3.1 Inherited Permissions

The Domain Source module uses the following permissions from the Domain
Access module:

  -- 'set domain access'
  This permission allows an editor to assign any content to any registered
  domain.  With Domain Source, it also allows users to assign that content to
  any domain as the "source" domain.

  -- 'view domain publishing'
  This permission lets affiliate editors select publishing options for the
  domains on which they are editors.  If these users are allowed to select
  the affiliate domains for their content, they will also be allowed to assign
  the "source" domain from the list of their editable domains.

Note that in all cases, the "source" domain must be selected as a publishing
option.  Failure to do so will return an error when the edit form is submitted.

All other users will have the currently active domain set as the "source"
domain.

----
3.2 Content Editing Forms

Users with the 'view domain publishing' permission will only be able to select
a "source" domain only if the "Content editing forms" setting on Admin > Build
> Domains is set to:

  -- Show user their publishing options
  The node editing form is shown normally, and the user is presented a
  list of checkboxes.  These options represent the affilaite domains that
  the user is allowed to publish content to, according to the domains
  assigned to their user account.

Otherwise, domain assignments will be done automatically, based on the currently
active domain.

----
3.3 Integration with Domain Content

This module adds an element to the Domain Content batch editing screen to
allow for the batch assignment of source domains.

However, this feature is currently only available to users with the 'set domain
access' permission.

----
4.  Developer Notes

The Domain Source module is recommended for most uses.  It is an extension
module because it alters the original design of the Domain Access module.

It is possible that Domain Source will be incorporated into the main module in
later releases.

----
4.1  Database Schema

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

  - nid
  Integer, unique, primary key
  The node id for this record, foreign key to the {node} tabl.

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