Archive - Dec 2004

Date
  • All
  • Jan
  • Feb
  • Mar
  • Apr
  • May
  • Jun
  • Jul
  • Aug
  • Sep
  • Oct
  • Nov
  • Dec
  • All
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31

Comments: Adding to the Discussion

This module allows users to post responses to other posts. Through administer you can configure what types of comments are accepted: anonymous, anonymous requiring an email address, or registered users only. You can also configure permissions for types of users (authenticated, administrative, or anonymous) so that comments written by the respective types of users enter an approval queue before they are published or are automatically published. Comments in the approval queue must be manually accepted and published by a site administrator. Comments are also searchable. Comments can be viewed seperately from their posts for easy editing and deleting.

( categories: )

Enabling CivicSpace Automated Tasks: Configuring Cron Jobs

Some CivicSpace modules, such as search, notify and aggregator, have periodic tasks that must be triggered by the script cron.php included with your CivicSpace installation. You can do this manually in your browser by visiting your cron URL page (a blank page will display once the cron tasks have been executed).

However, the better way to do this is to have cron.php executed automatically using the Linux/UNIX crontab function.

  • The following example crontab line will activate the cron script on the hour:
    0 * * * * wget -O - -q http://www.example.com/cron.php
  • If your host has the text browser lynx on the system, make use of the file provided in your Drupal installation in scripts/. Edit scripts/cron-lynx.sh, subsituting the name of your site. Then setup a crontab every hour:
    00 * * * * /home/www/drupal/scripts/cron-lynx.sh

Alternatively, Drupal has a poormanscron module available for download. However, this module is much less efficient in terms of system resources compared to the methods described above. The poormanscron module checks to see if cron needs to run every single time a page is viewed on the site.

More information about cron is available in the adminstration help page and at the Drupal Handbook Cron system and crontab page.

( categories: )

Formatting Input & Filters

CivicSpace site adminstrators can control what kinds of markup or formatting can be used in creating content on the site by specifying input formats. Some site administrators might wish to require only HTML coded text, or plain text without any HTML format. In configuring the input formats, administrators can select from filters which limit users to a list of allowable HTML tags or add in custom formatting like automatic line breaks.

NOTE: If you install additional 3rd party input filter modules, in addition to turning the modules on, you'll need to enable them through the input format configuration.

( categories: )

Main Configuration Settings

The Settings page, accessible at administer > settings, contains many general configuration settings for your CivicSpace site. Here you can modify some of the information you entered in the configuration wizard during initial site setup:

  • Name. The name of your CivicSpace site, displayed at the top of every page and also optionally as part of your theme in the header
  • E-mail address. The email address used as the "From" address for all emails sent out by your site, including for new user registration, forgotten password requests, and subscription notifications.
  • Slogan. A short descriptive phrase about your site, which is optionally displayed as part of your theme; required to be included in the CivicSpace directory. The slogan will also appear in the description for the site's RSS feeds.
  • Mission. Brief introduction to the purpose or goals of your site. Optionally displayed in a special style above the first post on your front page. Also required for the directory feature.
  • Footer message. Message that is optionally displayed at the bottom of pages as part of the theme. The default message contains a copyright notice which you can add to or modify.

Other default settings include

( categories: )

Licensing & Acknowledgments

The text of this guide is licensed under a Creative Commons Attribution-ShareAlike License (2.0). Permission to copy, modify, or redistribute this guide is only granted if this license is included and the CivicSpace Site Configuration Guide is attributed.

Content for this guide was produced by CivicSpace and was based on DrupalEd documentation. Thanks to Bryght for permission to draw on some of their How To's in constructing this guide.

( categories: )

Tracking and Statistics

CivicSpace provides a number of ways to find out who has been visiting the site and who has been posting content:

  • User list page. A table of users with their last access to the site.
  • CivicSpace logs provide userful statistics and system-generated messages:
    • Recent hits. Logs of access to individual site pages. Provides information such as username, IP address, and referring page.
    • Referrer logs. Site referers for both internal and external links.
( categories: )

Modules and Features

There are quite a few other modules listed on the module configuration page which have not so far been mentioned. In this section, you'll find descriptions of some of them. Some are currently running; others are turned off. You can also load other contributed modules by downloading them from drupal.org and installing them yourself. Make sure that they are for Drupal 4.6 or they may not work.

Always remember that whenever you enable a module, you should check any permissions the module might have associated with it in order for users to have access to the module. When working with permission settings, it is often useful to create a test user and grant them the role for the permissions you are enabling. Then login as that user and verify that you have indeed granted the permissions.

( categories: )

Users: Configuring Site Access, Registration, and Posting

CivicSpace has a permission system which places users into roles/groups of users. A visitor who is not logged in is an anonymous user and a newly registered user is an authenticated user. An additional role has been added to this installation, an admin user which is given full access on the site. In the original account setup, the root super user account which was created first is not affected by the CivicSpace permission system; this user always has access to everything.

Some configuration tips:

  • Registration. The default registration permission settings on this site allows anyone to register. The user settings page will allow you to change whether users can register on their own, require administrator approval, or not at all. The email sent to users can also be changed here, as well as the registration page information guidelines that users see when registering.
( categories: )

Blocks: Controlling Content in the Columns

CivicSpace page layout is very similar to many other websites: a header, a footer, a main content column down the center, and block columns down the side with links and other information. Blocks, then, are the small boxes of links, etc., you see in the left and/or right hand columns.

As an administrator, you can choose which blocks appear in the left or right and in what order (using weights) in the block administration section. You can create and edit custom blocks such as the Sample Block which uses HTML. There are also some other blocks included with the distribution which have not been enabled. Try them.

( categories: )

Creating and Working with Collaborative Books

The CivicSpace Site Configuration Guide has been created using the CivicSpace collaborative book. The collaborative book feature is well suited for creating multi-page hypertexts such as a site resource guides.

  • When creating a new book page, choose the Parent page to place the new page into the table of contents link structure (Note: you can always edit an existing page and use the Parent setting to reposition a book page within the text).
  • Book pages also have other navigation elements for moving through the text, such as the previous, up and next elements visible at the bottom of this page
  • From any location in a book, the user can choose the printer-friendly version link at the bottom of the page. CivicSpace will then generate a version of the book containing the current page and all it's children.

To control the ordering of book pages in the table of contents structure, visit the book configuration section. For example, look at the CivicSpace Site Configuration Guide configuration page. There you can easily view all the pages in this text, as well as order them. Notice the weight menu beside each page listing. CivicSpace normally orders pages on the same "level" within the text alphabetically. You can override that ordering by giving pages which should be higher up lighter weights--negative numbers--or lower down heavier weights--positive numbers.

To create a new book, simply make the Parent "root."

Last, a blog post, forum post, story, or static page can also be added into a book. Choose the administer link for a given post or page, then use the Edit book outline button available at the bottom of the page to add it into an existing book.

( categories: )