From Fedora Project Wiki

m (internal link cleaning)
 
(14 intermediate revisions by 4 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 [[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/views Views] module.</li>
<li>Install the [http://drupal.org/project/advanced_help Advanced Help] 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 26: 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 38: 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
* 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:
<li>Enable the following modules in the ''Views'' section:
* Views
* Views
* Views Bulk Operations
* Views UI</li>
* Views UI</li>
</ol>
</ol>
Line 53: 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>
Line 64: Line 103:
<ol>
<ol>
<li>Add the Planet to the site:
<li>Add the Planet to the site:
<ol><li>Under ''Feed aggregator'' add the [http://planet.fedoraproject.org/rss20.xml RSS 2.0 feed for Planet Fedora] as a new source, with the name ''Planet Fedora''.</li>
<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''.</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>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>
</li>
</ol>
</ol>
Line 89: 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
|-
|-
| access news feeds ||  || {{check}} ||  ||  ||
| view advanced help index ||  ||  || {{check}} ||  ||
|-
|-
| administer news feeds ||  ||  || {{check}} ||  ||
| view advanced help popup ||  ||  || {{check}} ||  ||
|-
| view advanced help topic ||  ||  || {{check}} ||  ||
|-
|-
! colspan=6 style="text-align: left;" | authfas module
! colspan=6 style="text-align: left;" | authfas module
Line 104: 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 151: 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 157: 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 163: 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 171: 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 177: 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 199: 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 213: Line 252:
| access user profiles ||  ||  || {{check}} ||  ||  
| access user profiles ||  ||  || {{check}} ||  ||  
|-
|-
| administer permissions ||  ||  || ||  ||  
| administer permissions ||  ||  || {{check}} ||  ||  
|-
|-
| administer users ||  ||  || {{check}} ||  ||  
| administer users ||  ||  || {{check}} ||  ||  
Line 219: 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>

Latest revision as of 14:32, 18 September 2016

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.
  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
      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