End-User Guide

Welcome! This guide describes how to get started using IHEYO's
web-site. The guide covers basic topics
such as registering for an account, logging in, changing your account
settings, and creating content, but first a few words on the technical
how and why's of this website.

www.iheyo.org is made with Drupal. Drupal is a content
management system
. Its goal is to help users compose and
present web-site content such as articles, photos, and other content
types. Drupal is a "dynamic" system; rather than forcing users to
specify a fixed, pre-declared arrangement of content, Drupal takes care
of the details of how information is arranged and presentated, and lets
users focus on the actual content to be displayed.

Most of the content on a Drupal-based site (the text of this
page, for example) is stored in a database. Text and images are
submitted by filling in forms via a web browser. When visitors (like
you) view a page, Drupal gets the relevant bits of content from the
database and composes all of the components of the page in a template.
This makes it easy to quickly add or change content, without requiring
knowledge of HTML or other web technologies on the part of the person
providing the content.

Depending on the configuration of the Drupal site and the
user-roles you play with respect to that site, you may be allowed to
contribute or edit content. Fortunately, Drupal is designed to make
this relatively easy. Very little technical knowledge is assumed.
Though details may vary with a site's configuration, the basic process
involves these steps:

  • register with the site
  • log in by typing the user name and
    password supplied you in the registration step, and
  • create content such as articles and
    stories

This user guide will explain these steps and familiarize you
with the basic information you need to use Drupal successfully.

Registering as a user

To add or edit content on this site, you first have to be
registered as a user. In some cases, a site administrator will add you
as a user. If so, they will send you a user name and password that you
can use to log on.

Otherwise, look for a small form called “User
login” on the right of the main page. Click the link that
says "Create new account".

The next page that comes up will have some information on the
site's policies for registration. After reading them, to register,
enter a user name of your choice and an email address to which you have
access and hit "submit". Then check your email account. As soon as the
webmaster has accepted your registration (usually by the next working
day), you should get an automatically-generated email confirming your
registration and giving you an initial password to use. Now you're
ready to log in.

Logging in

Before you can add or edit content, need to log in. If you
haven't already done so, register as a user, see above. Then hit the
main page of the site you're wishing to use and look for the "User
login" form on the right side of the page (it is a "block" in Drupal
talk). Enter your user name and password and hit "submit".

Assuming everything's working as planned, when the new page
loads it will include a new block with your user name at the top. This
is the menu you use to start entering and editing content.

Changing your account settings

Once you have registered with a Drupal-based site, you can
change settings to control information about yourself and also your use
and experience of a Drupal site. To see what changes you can make to
your account, log in and then click on my account
in the navigation block (that's the one titled with your user name).
Click on the edit tab.

Account Settings. You may see a different
collection of settings than is presented here, depending on what
features have been enabled on your site.

password
Enter in a new password in both fields to set it. Drupal
sends you a default password that is often hard to remember, so it is
recommended that you change your password to something you can easily
remember.
block configuration
The site administrator has made some blocks (chunks of
content that are usually displayed in a left and/or right column)
optional. You can enable and disable the display of these blocks by
checking and unchecking the boxes next to them.
signature
Comments are enabled, you will be able to set a default
signature. This will be copied into new comments for you automatically,
but may still be edited.
time zone
Your site administrator has allowed users to set their time
zone. This will cause all dated content on the site to display in local
time, according to the offset you enter here.
theme
A "theme" is the basic look and feel of a Drupal site. On
IHEYO.org, you can either stick with the red default theme, or switch
to a lighter, all-white background. You are able to select what you
would like the default theme to be for your account.

Additional Information. Aside from the
account settings tab, you may also see additional tabs, titled
according to the information they contain. Some examples might include
"Personal Information", "Workplace", etc. These are controlled by the
profile module, and allowsyou to enter more information about yourself.
Please see the profile module for more information on this.

Creating new content

Once you have logged-in, you're ready to start posting content.

At the top of your personal menu, you'll find a link called
"create content". Click this and you'll see a list of the types of
content you can create. Depending on your user status (ordinary user or
administrator), you'll see more or less content types such as pages,
stories, image galleries etc.

A step-by-step example

We will assume that you have selected create content
and chosen "story" as a content type.

You should be looking at a form with the title "Submit story".
From here, it is just a matter of filling in the form and posting it.

Administrative options

At the top of the form you may see some administrative
options. For example, there is a box with the heading User
comments
. Drupal supports discussion/comments on
postings--but such comments are not always appropriate. If your article
is one that could be usefully commented on, keep the default settings:
"Read/write". Otherwise, choose "Disabled".

Title

The title is straightforward enough. Try to be
descriptive and catchy.

Then, there are four boxes. From the first two, you can
pick keywords describing the content of your contribution. If you want
to select several keywords, hold the "Control"-button while clicking
them. In the two other boxes, you can freely enter the location/country
that is treated and the language of your contribution. By selecting
one, you choose where on the site to categorize your
article. If this seems hard to relate to, you can think of topics as
being like folders on your hard drive--they help to organize content,
so that you can find similar things in the same place. These words
appear at the bottom of the page you've created.

Body

The "body" field is where you put the main content of the
page. If you've typed this into a word processor or HTML editor, just
copy and paste it into this field. Alternately you can just type
straight in. For the most basic page, just type and leave a blank line
(i.e., hit "enter" twice) at the and of each paragraph.

Decide where you want the "teaser" (the part of the main
text used in links to the article) to end. If you do nothing, Drupal
will choose a breaking point for you -- but it's better to decide
yourself, to make sure the breaking point is appropriate. You do this
by typing in a <!--break--> where the teaser is to
end.

And you're set! You can preview the page you've prepared by hitting
"Preview" (recommended, and sometimes required) or you can bravely or
recklessly just go ahead and publish it by hitting "Submit".

Permissions

What types of content you can create or edit depends on the
privileges assigned to the "role" or user group that you're a member
of. In general, to find out what you can do:

  • On your user menu (the collection of links that has your
    user name as a title), look for a link that says "create content".
    Click this to get a listing of the types of content you have permission
    to post.
  • On a particular page, look for links at the bottom of an
    article. These links say things like "12 comments" (if there are
    comments that have been made on the article) and "read more" (if you're
    looking at a short version of an article). If one of these links say
    "administer" or something like "edit this page", you have permissions
    to edit that type of content.

Creating comments

Comments allow you to interact with the content on a site, to
respond to an article, offer their own ideas, make additions, or supply
a critique.

Leaving comments

When you bring up an article to read, look for
comment-related links at the bottom of the article. If you're not
logged in, this might read "login or register to post comments". When
you do log in, you should see something like "Add new comment". Click
on the link and you're ready to comment away.

Etiquette

Comments can be a great way of enriching a community
site--but they can also lead to unfriendly, even harassing exchanges.
As with any communication, it's important to try to ensure that your
comments are respectful and constructive.

"Threaded" comments

Comments on a Drupal web-site are "threaded". This means
you can comment directly on an article--or you can reply to an existing
comment. If you reply, your comment will be indented to show that it is
part of that discussion.

Editing and deleting content

To edit or delete existing content, log in and then bring up
the page you wish to edit. Look on the page for an "edit" tab.
Depending on your user permissions, you might see this on all pages or
only on certain ones. For example, on iheyo.org, you should see the
edit tab for those pages that you submitted.

Clicking the edit tab will bring up a page with a form for
changing the page. Here you can change the text and settings. Once you
have the text and settings in a suitable form, click on the "Submit"
button on the bottom of the form. Note that certain sites may be set up
to require you to "Preview" the page before you can submit your changes.

If you wish to delete the page (and you have appropriate
permissions), click on the "delete" button near the bottom of the form.
You'll get a second chance to confirm that you wish to delete the page,
or to change your mind!