From Fedora Project Wiki

No edit summary
(20 intermediate revisions by 5 users not shown)
Line 5: Line 5:
If you're finished already with these general customizations, there's another page about [[Insight content configuration]].
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 [[EPEL/FAQ#howtouse | here]].
'''Note:''' to install a package feel free to use either '''rpm''' or '''yum''' commands. Syntax is: <pre>rpm -i 'package-name'
yum install 'package-name'</pre> 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''':
<ol>
<li>drupal6</li>
<li>drupal6-footnotes</li>
<li>drupal6-advanced-help</li>
<li>drupal6-auto_nodetitle</li>
<li>drupal6-ctools</li>
<li>drupal6-feeds</li>
<li>drupal6-job_scheduler</li>
<li>drupal6-pathauto</li>
<li>drupal6-token</li>
<li>drupal6-views_bulk_operations</li>
<li>drupal6-flexifilter</li>
<li>drupal6-views</li>
<li>drupal6-cck</li>
</ol>


== General changes ==
== General changes ==
<!-- Use a <ol> here so we can embed code in each list item -->
<!-- Use a <ol> here so we can embed code in each list item -->
<ol>
<ol>
<li>It may be necessary to alter the <code>/etc/cron.hourly/drupal6</code> cron script to ensure it points to the right location ("/drupal" vs. "/drupal6").</li>
<li>Install the AuthFAS module. The source is found [http://fedorapeople.org/gitweb/pfrields/public_git/drupal-authfas-6x.git here].
<li>Install the AuthFAS module. The source is found [http://fedorapeople.org/gitweb/pfrields/public_git/drupal-authfas-6x.git here].


Line 14: Line 38:
git clone git://fedorapeople.org/home/fedora/pfrields/public_git/drupal-authfas-6x.git authfas</pre>
git clone git://fedorapeople.org/home/fedora/pfrields/public_git/drupal-authfas-6x.git authfas</pre>
</li>
</li>
<li>Install the Insight theme. ''(This doesn't exist yet, but it will. When it does, fill out this step. --[[User:Pfrields|pfrields]] 19:33, 14 August 2010 (UTC))''</li>
<li>Install the [http://fedoraproject.org/wiki/How_to_work_on_the_Insight_theme Insight theme]. </li>
 
<li>Install the [http://drupal.org/project/cck CCK] module.</li>
<li>Install the [http://drupal.org/project/flexifilter Flexifilter] module.</li>
<li>Install the [http://drupal.org/project/flexifilter Flexifilter] module.</li>
<li>Install the [http://drupal.org/project/footnotes Footnotes] module.</li>
<li>Install the [http://drupal.org/project/footnotes Footnotes] module.</li>
<li>Install the [http://drupal.org/project/views Views] module.</li>
<li>Install the [http://drupal.org/project/advanced_help Advanced Help] module.</li>
<li>Install the [http://drupal.org/project/auto_nodetitle Automatic Node Title] module.</li>
<li>Install the [http://drupal.org/project/ctools Chaos tool suite] module.</li>
<li>Install the [http://drupal.org/project/feeds Feeds] module.</li>
<li>Install the [http://drupal.org/project/job_scheduler Job Scheduler] module.</li>
<li>Install the [http://drupal.org/project/pathauto Pathauto] module.</li>
<li>Install the [http://drupal.org/project/token Token] module.</li>
<li>Install the [http://drupal.org/project/views_bulk_operations Views Bulk Operations] module.</li>
</ol>
</ol>


Line 24: Line 57:
<ol>
<ol>
<li>In the ''Modules'' configuration module, enable the following modules in the ''Core - Optional'' section:
<li>In the ''Modules'' configuration module, enable the following modules in the ''Core - Optional'' section:
* Aggregator
* Book
* Color
* Color
* Comment
* Comment
Line 36: Line 67:
* Trigger
* Trigger
* Update status</li>
* Update status</li>
<li>Enable the following modules in the ''Feeds'' section:
* Feeds
* Feeds Admin UI
* Feeds News</li>
<li>Enable the ''Flexifilter'' module in the ''Flexifilter'' section.</li>
<li>Enable the ''Flexifilter'' module in the ''Flexifilter'' section.</li>
<li>Enable the following modules in the ''Other'' section:
<li>Enable the following modules in the ''Other'' section:
* Advanced Help
* AuthFAS
* AuthFAS
* Footnotes</li>
* Automatic Nodetitles
* Footnotes
* Job Scheduler
* Pathauto
* Token
* Token Actions</li>
<li>Enable the following modules in the ''Views'' section:
* Views
* Views Bulk Operations
* Views UI</li>
</ol>
</ol>


Line 47: Line 92:
<li>Ensure the ''Site information'' settings are properly configured.</li>
<li>Ensure the ''Site information'' settings are properly configured.</li>
<li>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''.
<li>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''.
<pre>Location of FAS instance:  publictest4.fedoraproject.org/accounts
<pre>Location of FAS instance:  https://fakefas01.fedoraproject.org/accounts
FAS group for authenticated users:  cla_done
FAS group for authenticated users:  cla_done
Email domain used for FAS users:  fedoraproject.org</pre>
Email domain used for FAS users:  fedoraproject.org</pre>
</li>
</li>
<li>Enable ''Clean URLs''. If you cannot enable them, your site is misconfigured. Visit the {{filename|/usr/share/drupal6/.htaccess}} file and ensure that you've changed it according to the [[How to install Drupal]] page.</li>
<li>Enable ''Clean URLs''. If you cannot enable them, your site is misconfigured. Visit the {{filename|/usr/share/drupal6/.htaccess}} file and ensure that you've changed it according to the [[How to install Drupal]] page.</li>
<li>In the ''Performance'' settings, enable ''Normal'' caching. This should not affect development work.</li>
<li>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.)</li>
</ol>
</ol>


== Content management ==
== Content management ==
<ol>
<li>Add the Planet to the site:
<ol><li>Under ''Import menu/Feed menu item'' add the [http://planet.fedoraproject.org/rss20.xml RSS 2.0 feed for Planet Fedora] as a new source url, with the name ''Planet Fedora''.</li>
<li>Set the update interval to ''1 hour'' under domainname/admin/build/feeds/edit/feed/settings page.</li>
<li>Under ''Site building'' visit the ''Blocks'' menu, place the new Planet aggregator in the right sidebar.  The other defaults are acceptable.</li>
</li></ol>
<li>Add new content to the site:
<ol><li>Click on the "Create content" on the right menu panel,</li>
<li>Select which kind of content do you want to add. Options are:</li>
* 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
</li>
</ol>


== User management ==
== User management ==
Line 76: Line 136:
! Permission !! anonymous user !! authenticated user !! administrator !! editor !! writer
! Permission !! anonymous user !! authenticated user !! administrator !! editor !! writer
|-
|-
! colspan=6 style="text-align: left;" | aggregator module  
! colspan=6 style="text-align: left;" | advanced_help module
|-
| view advanced help index ||  ||  || {{check}} ||  ||
|-
|-
| access news feeds ||  || {{check}} ||  ||  ||
| view advanced help popup ||  ||  || {{check}} ||  ||
|-
|-
| administer news feeds ||  ||  || {{check}} ||  ||
| view advanced help topic ||  ||  || {{check}} ||  ||
|-
|-
! colspan=6 style="text-align: left;" | authfas module
! colspan=6 style="text-align: left;" | authfas module
Line 91: Line 153:
|-
|-
| use PHP for block visibility ||  ||  || {{check}} ||  ||
| use PHP for block visibility ||  ||  || {{check}} ||  ||
|-
! colspan=6 style="text-align: left;" | book module
|-
| access printer-friendly version ||  || {{check}} ||  ||  ||
|-
| add content to books ||  ||  || {{check}} || {{check}} || {{check}}
|-
| administer book outlines ||  ||  || {{check}} || {{check}} || {{check}}
|-
| create new books ||  ||  || {{check}} || {{check}} || {{check}}
|-
|-
! colspan=6 style="text-align: left;" | comment module
! colspan=6 style="text-align: left;" | comment module
Line 115: Line 167:
|-
|-
| administer filters ||  ||  || {{check}} ||  ||  
| administer filters ||  ||  || {{check}} ||  ||  
|-
! colspan=6 style="text-align: left;" | flexifilter module
|-
| administer flexifilter ||  ||  || {{check}} ||  ||
|-
|-
! colspan=6 style="text-align: left;" | locale module
! colspan=6 style="text-align: left;" | locale module
Line 134: Line 190:
| administer nodes ||  ||  || {{check}} || {{check}} ||  
| administer nodes ||  ||  || {{check}} || {{check}} ||  
|-
|-
| create book content ||  ||  || {{check}} || {{check}} || {{check}}
| create fwnbeat content ||  ||  || {{check}} || {{check}} ||
|-
|-
| create page content ||  ||  || {{check}} || {{check}} ||
| create page content ||  ||  || {{check}} || {{check}} ||
Line 140: Line 196:
| create story content ||  ||  || {{check}} || {{check}} || {{check}}
| create story content ||  ||  || {{check}} || {{check}} || {{check}}
|-
|-
| delete any book content ||  ||  || {{check}} || {{check}} ||
| delete any fwnbeat content ||  ||  || {{check}} || {{check}} ||
|-
|-
| delete any page content ||  ||  || {{check}} ||  ||  
| delete any page content ||  ||  || {{check}} ||  ||  
Line 146: Line 202:
| delete any story content ||  ||  || {{check}} ||  ||
| delete any story content ||  ||  || {{check}} ||  ||
|-
|-
| delete own book content ||  ||  || {{check}} || {{check}} || {{check}}
| delete own fwnbeat content ||  ||  || {{check}} || {{check}} ||
|-
|-
| delete own page content ||  ||  || {{check}} || {{check}} ||
| delete own page content ||  ||  || {{check}} || {{check}} ||
Line 154: Line 210:
| delete revisions ||  ||  || {{check}} || {{check}} ||
| delete revisions ||  ||  || {{check}} || {{check}} ||
|-
|-
| edit any book content ||  ||  || {{check}} || {{check}} ||
| edit any fwnbeat content ||  ||  || {{check}} || {{check}} ||
|-
|-
| edit any page content ||  ||  || {{check}} || {{check}} ||
| edit any page content ||  ||  || {{check}} || {{check}} ||
Line 160: Line 216:
| edit any story content ||  ||  || {{check}} || {{check}} ||  
| edit any story content ||  ||  || {{check}} || {{check}} ||  
|-
|-
| edit own book content ||  ||  || {{check}} || {{check}} || {{check}}
| edit own fwnbeat content ||  ||  || {{check}} || {{check}} ||
|-
|-
| edit own page content ||  ||  || {{check}} || {{check}} ||  
| edit own page content ||  ||  || {{check}} || {{check}} ||  
Line 182: Line 238:
| administer site configuration ||  ||  || {{check}} ||  ||  
| administer site configuration ||  ||  || {{check}} ||  ||  
|-  
|-  
| select different theme ||  ||  || {{check}} ||  ||
| select different theme ||  || {{check}} ||  ||  ||
|-
|-
! colspan=6 style="text-align: left;" | taxonomy module
! colspan=6 style="text-align: left;" | taxonomy module
Line 196: Line 252:
| access user profiles ||  ||  || {{check}} ||  ||  
| access user profiles ||  ||  || {{check}} ||  ||  
|-
|-
| administer permissions ||  ||  || ||  ||  
| administer permissions ||  ||  || {{check}} ||  ||  
|-
|-
| administer users ||  ||  || {{check}} ||  ||  
| administer users ||  ||  || {{check}} ||  ||  
Line 202: Line 258:
| change own username ||  ||  ||  ||  ||  
| change own username ||  ||  ||  ||  ||  
|-
|-
! colspan=6 style="text-align: left;" | views module
|-
| access all views ||  ||  || {{check}} || {{check}} ||
|-
| administer views ||  ||  || {{check}} ||  ||
|}
|}
</li></ol>
</li></ol>

Revision as of 08:25, 21 December 2012

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

Note.png
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.
  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:  https://fakefas01.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 Checkmark.png
      view advanced help popup Checkmark.png
      view advanced help topic Checkmark.png
      authfas module
      administer FAS settings
      block module
      administer blocks Checkmark.png
      use PHP for block visibility Checkmark.png
      comment module
      access comments Checkmark.png
      administer comments Checkmark.png
      post comments Checkmark.png
      post comments without approval Checkmark.png
      filter module
      administer filters Checkmark.png
      flexifilter module
      administer flexifilter Checkmark.png
      locale module
      administer languages Checkmark.png
      translate interface Checkmark.png
      menu module
      administer menu Checkmark.png
      node module
      access content Checkmark.png Checkmark.png
      administer content types Checkmark.png Checkmark.png
      administer nodes Checkmark.png Checkmark.png
      create fwnbeat content Checkmark.png Checkmark.png
      create page content Checkmark.png Checkmark.png
      create story content Checkmark.png Checkmark.png Checkmark.png
      delete any fwnbeat content Checkmark.png Checkmark.png
      delete any page content Checkmark.png
      delete any story content Checkmark.png
      delete own fwnbeat content Checkmark.png Checkmark.png
      delete own page content Checkmark.png Checkmark.png
      delete own story content Checkmark.png Checkmark.png Checkmark.png
      delete revisions Checkmark.png Checkmark.png
      edit any fwnbeat content Checkmark.png Checkmark.png
      edit any page content Checkmark.png Checkmark.png
      edit any story content Checkmark.png Checkmark.png
      edit own fwnbeat content Checkmark.png Checkmark.png
      edit own page content Checkmark.png Checkmark.png
      edit own story content Checkmark.png Checkmark.png Checkmark.png
      revert revisions Checkmark.png Checkmark.png
      view revisions Checkmark.png Checkmark.png Checkmark.png
      system module
      access administration pages Checkmark.png
      access site reports Checkmark.png
      administer actions Checkmark.png
      administer files Checkmark.png
      administer site configuration Checkmark.png
      select different theme Checkmark.png
      taxonomy module
      administer taxonomy Checkmark.png Checkmark.png
      translation module
      translate content Checkmark.png
      user module
      access user profiles Checkmark.png
      administer permissions Checkmark.png
      administer users Checkmark.png
      change own username
      views module
      access all views Checkmark.png Checkmark.png
      administer views Checkmark.png

    Reports

    TBD