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.

Packaging Details

Note: to install the following packages, please enable EL5/6 repositories as explained here.

Note: to install a package feel free to use either rpm or yum commands. Syntax is:

rpm -i 'package-name'
yum install 'package-name'

where package-name is the value available in the table below.

Before moving to the second step of this wiki page, please make sure you grab the following packages from El5 and El6:

1. drupal6
2. drupal6-footnotes
3. drupal6-advanced-help
4. drupal6-auto_nodetitle
5. drupal6-ctools
6. drupal6-feeds
7. drupal6-job_scheduler
8. drupal6-pathauto
9. drupal6-token
10. drupal6-views_bulk_operations
11. drupal6-flexifilter
12. drupal6-views
13. drupal6-cck

General changes

1. It may be necessary to alter the /etc/cron.hourly/drupal6 cron script to ensure it points to the right location ("/drupal" vs. "/drupal6").
2. 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

3. 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))
4. Install the CCK module.
5. Install the Flexifilter module.
6. Install the Footnotes module.
7. Install the Views module.
8. Install the Advanced Help module.
9. Install the Automatic Node Title module.
10. Install the Chaos tool suite module.
11. Install the Feeds module.
12. Install the Job Scheduler module.
13. Install the Pathauto module.
14. Install the Token module.
15. Install the Views Bulk Operations module.

Site building

1. In the Modules configuration module, enable the following modules in the Core - Optional section:
   • Color
   • Comment
   • Content translation
   • Database logging
   • Help
   • Menu
   • Search
   • Taxonomy
   • Trigger
   • Update status
2. Enable the following modules in the Feeds section:
   • Feeds
   • Feeds Admin UI
   • Feeds News
3. Enable the Flexifilter module in the Flexifilter section.
4. Enable the following modules in the Other section:
   • Advanced Help
   • AuthFAS
   • Automatic Nodetitles
   • Footnotes
   • Job Scheduler
   • Pathauto
   • Token
   • Token Actions
5. Enable the following modules in the Views section:
   • Views
   • Views Bulk Operations
   • Views UI

Site configuration

1. Ensure the Site information settings are properly configured.
2. 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

3. 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.
4. 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.)

Content management

1. Add the Planet to the site:
   1. Under Import menu/Feed menu item add the RSS 2.0 feed for Planet Fedora as a new source url, with the name Planet Fedora.
   2. Set the update interval to 1 hour under domainname/admin/build/feeds/edit/feed/settings page.
   3. Under Site building visit the Blocks menu, place the new Planet aggregator in the right sidebar. The other defaults are acceptable.
2. Add new content to the site:
   1. Click on the "Create content" on the right menu panel,
   2. Select which kind of content do you want to add. Options are:
   • Page, is a simple method for creating and displaying information that rarely changes, such as an "About us" section of a website.
   • Story, is ideal for creating and displaying content that informs or engages website visitors.(i.e Press releases, site announcements or informal blog entries)
   • Weekly News Beat, A single "beat" or topical area in the Fedora Weekly News

   User management

   1. In the User settings module, set Public registrations to Only site administrators can create new user accounts.
   2. In the User settings module, disable signature and picture support.
   3. 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.
   4. In the Permissions module, set the following permissions:
      
      

      Permission	anonymous user	authenticated user	administrator	editor	writer
      advanced_help module
      view advanced help index
      view advanced help popup
      view advanced help topic
      authfas module
      administer FAS settings
      block module
      administer blocks
      use PHP for block visibility
      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 fwnbeat content
      create page content
      create story content
      delete any fwnbeat content
      delete any page content
      delete any story content
      delete own fwnbeat content
      delete own page content
      delete own story content
      delete revisions
      edit any fwnbeat content
      edit any page content
      edit any story content
      edit own fwnbeat 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
      views module
      access all views
      administer views

   Reports

   TBD