Insight customizations to Drupal

This page tracks customizations made to a Drupal-based test instance for Fedora Insight.

Administrator access
You'll need full access to Drupal uid 1 (the site administrator account) to complete some of these steps.

If you're finished already with these general customizations, there's another page about Insight content configuration.

General changes

Install the AuthFAS module. The source is found here.

cd /etc/drupal6/all/modules/
git clone git://fedorapeople.org/home/fedora/pfrields/public_git/drupal-authfas-6x.git authfas

Install the Insight theme. (This doesn't exist yet, but it will. When it does, fill out this step. --pfrields 19:33, 14 August 2010 (UTC))
Install the Flexifilter module.
Install the Footnotes module.
Install the Views module.
Install the Advanced Help module.

Ensure the Site information settings are properly configured.
Configure the AuthFAS module with the following settings. The settings below point the AuthFAS module to a FAS instance on publictest4, and requires that anyone logging in be a member of the cla_done FAS group. Furthermore, it sets up email for each new user at username@fedoraproject.org.
```
Location of FAS instance:  publictest4.fedoraproject.org/accounts
FAS group for authenticated users:  cla_done
Email domain used for FAS users:  fedoraproject.org
```
Enable Clean URLs. If you cannot enable them, your site is misconfigured. Visit the /usr/share/drupal6/.htaccess file and ensure that you've changed it according to the How to install Drupal page.
In the Performance settings, enable Normal caching. This should not affect development work. (If you find pages are not being refreshed as expected during development, disable caching.)

Add the Planet to the site:

Under Feed aggregator add the RSS 2.0 feed for Planet Fedora as a new source, with the name Planet Fedora.
Set the update interval to 1 hour.
Under Site building visit the Blocks menu, place the new Planet aggregator in the right sidebar. The other defaults are acceptable.

In the User settings module, set Public registrations to Only site administrators can create new user accounts.
In the User settings module, disable signature and picture support.
In the FAS instance, create three new groups:
- cmsadmin
- cmseditor
- cmswriter
In the Drupal instance, create three new roles:
- administrator
- editor
- writer
Edit each role to hook it to the appropriate FAS group listed above. To grant users more access to help with Drupal, use the FAS system -- not the Drupal instance.

In the Permissions module, set the following permissions:

Permission	anonymous user	authenticated user	administrator	editor	writer
aggregator module
access news feeds
administer news feeds
authfas module
administer FAS settings
block module
administer blocks
use PHP for block visibility
book module
access printer-friendly version
add content to books
administer book outlines
create new books
comment module
access comments
administer comments
post comments
post comments without approval
filter module
administer filters
flexifilter module
administer flexifilter
locale module
administer languages
translate interface
menu module
administer menu
node module
access content
administer content types
administer nodes
create book content
create page content
create story content
delete any book content
delete any page content
delete any story content
delete own book content
delete own page content
delete own story content
delete revisions
edit any book content
edit any page content
edit any story content
edit own book content
edit own page content
edit own story content
revert revisions
view revisions
system module
access administration pages
access site reports
administer actions
administer files
administer site configuration
select different theme
taxonomy module
administer taxonomy
translation module
translate content
user module
access user profiles
administer permissions
administer users
change own username

TBD