modules/recent_blocks/README.txt

CONTENT:
--------
1. Module description
2. Typical usage
3. Installation/configuration

1. Module  description
----------------------

This module creates 'recent content' blocks, similar to the ones provided by
tracker module and comment module, but better ;) It works only for node-types.
You start with one block and can add new block on the fly, with one click.
This module is very simple and small, if you need anything more sophisticated
you might want to check 'views' module.

Each block displays 'recent content' in the form of a list, and can be 
configured:
- which node types are considered (forum, page, books etc)
- whether consider comments (replies) or not
- how many items to display
- block title to display
- sort by what
- what elements to display (title, date, replies)
- custom link
- [common options: on which pages display the block, etc]


2. Typical usage
----------------

Usually I create 2 blocks for the fronpage: 
- one that lists all node types except forum, and does not consider comments. 
  This block lists changes in articles created by site admins, lists real
  content that was recently added or updated
- one block that lists all node types and also considers comments.
  This block is for 'live' content, i.e. what other users read and reply.

I also create one block only for forum pages, that lists only forum type and 
also consider comments. Users can see which forum topics were recently added 
or to which other users recently replied.


3. Installation/configuration
-----------------------------

Enable the module. In administer > recent blocks you can see all your recent 
blocks (one is defined by default), you can add new block, delete existing one 
and configure them.

Remember, that after the block is configured, you have to enable it. You can
do it from normal administer > blocks page, there's also a link to that page 
from recent blocks page.

1	CONTENT:
2	--------
3	1. Module description
4	2. Typical usage
5	3. Installation/configuration
6
7	1. Module description
8	----------------------
9
10	This module creates 'recent content' blocks, similar to the ones provided by
11	tracker module and comment module, but better ;) It works only for node-types.
12	You start with one block and can add new block on the fly, with one click.
13	This module is very simple and small, if you need anything more sophisticated
14	you might want to check 'views' module.
15
16	Each block displays 'recent content' in the form of a list, and can be
17	configured:
18	- which node types are considered (forum, page, books etc)
19	- whether consider comments (replies) or not
20	- how many items to display
21	- block title to display
22	- sort by what
23	- what elements to display (title, date, replies)
24	- custom link
25	- [common options: on which pages display the block, etc]
26
27
28	2. Typical usage
29	----------------
30
31	Usually I create 2 blocks for the fronpage:
32	- one that lists all node types except forum, and does not consider comments.
33	This block lists changes in articles created by site admins, lists real
34	content that was recently added or updated
35	- one block that lists all node types and also considers comments.
36	This block is for 'live' content, i.e. what other users read and reply.
37
38	I also create one block only for forum pages, that lists only forum type and
39	also consider comments. Users can see which forum topics were recently added
40	or to which other users recently replied.
41
42
43	3. Installation/configuration
44	-----------------------------
45
46	Enable the module. In administer > recent blocks you can see all your recent
47	blocks (one is defined by default), you can add new block, delete existing one
48	and configure them.
49
50	Remember, that after the block is configured, you have to enable it. You can
51	do it from normal administer > blocks page, there's also a link to that page
52	from recent blocks page.
53