MDL-20523 Script for upgrading sites that use the old bloglevel settings.
[moodle.git] / blog / README.txt
1 =================================================
2 MOODLE BLOG
3 =================================================
5 This moodle module is based on the Simplog blogging system.
6 You can find more information on simplog at
7 http://www.simplog.net / http://www.simplog.org
8 Moodle integration work by Daryl Hawes.
10 =================================================
11 TESTERS WANTED
12 =================================================
14 This module is currently in the alpha testing phase.
16 I would appreciate feedback on any interface or functionality issues 
17 that you have. Please post your comments on moodle.org. Click "Free Support"
18 from the main page and then click "Blogs" to join the discussion.
20 Special thanks to these testers deserving of mention:
21 Tom Murdock
22 WP1
23 Dan Marsden
25 =================================================
26 TESTING
27 =================================================
28 There is online help available by adding the "Blog Menu" block and then clicking the Blog Help link. The online help is quickly getting out of date and could use some help - if you
29 make any modifications please send them my way for inclusion (or just commit them if you have cvs access.)
31 Once you have the files in place, either by copying the full easy distribution or by copying the files from cvs over an existing 
32 installation, you'll need to initialize moodle and complete the installation.
34 -- Admin your server --
35 Now that the moodle blog components are in place you'll want to update your database to support it. Visit yoursite.com/moodle/admin/ to 
36 run the database updates.
38 When the updates has been completed click the continue link to continue on to the variables setup page. 
39 When you're done configuring basic moodle settings then visit the admin area again and click on the 'Blog" link to admin site wide blog 
40 settings.
42 -- Access blogs --
43 To get started blogging you can stop by your blog index page at yoursite.com/moodle/blog/ or you can create a new course and use the 
44 Blog Menu block. Each user will need to click the "enable your blog" link to be able to add entries.
45 Note that when you add an entry the entry form recognizes whether you came from a course page. 
46 If you came from a course page the entry becomes associated with that course. 
47 If you did not get to the add and entry form from a course then your entry will be considered a general entry and not associated with 
48 any course.
50 Extra Credit:
51 Dan Marsden has some good tips on getting a high level of
52 error and warning output when testing development code. Perhaps you can
53 try various settings to give us extra feedback. Note that you would also want to
54 have the moodle debugging option turned on in the moodle admin configuration page.
56 "There are 3 things I have set differently (as far as I can remember!)
57     in the Moodle install process I set the debuging to be "on"
58     in php.ini file,�
59         error_reporting = E_ALL
60     and in my browser [Ed. I assume he is on a windows machine likely using some form of IE],
61         internet options > advanced 
62         under the browsing section
63         display a notification about every script error selected
64         disable Script debugging unselected."
65              --Dan Marsden, 2004
68 =================================================
69 README CONTENTS ADAPTED FROM SIMPLOG
70 =================================================
71  
72 Welcome to Moodle Blog (based on Simplog)!
74 Thanks for downloading this software while it in its testing phase.
75  
76 Simplog is free software, released under the GPL:
77 http://www.gnu.org/copyleft/gpl.html GNU Public License
79 Simplog was created to provide people with an easy way to create and maintain their own personal or a community weblog.  With the increasing number of people creating on-line journals, there is a need for a tool that allows them a quick and easy way to share their 
80 lives with the rest of the world.
82 Moodle Blog is designed first and foremost with personal expression in mind. It is not
83 implemented as an assignment or course module within Moodle. Rather, it is incorporated
84 directly and is independent of any course. Each user has the ability to create one
85 personal blog where they can post their personal reflections. A 'course blog' is just
86 an aggregate of entries from individual user blogs that have been flagged as being
87 'associated' with that course.
89 Daryl Hawes
93 Relevant portion of Simplog.net notes (from CREDITS.txt file removed from distribution):
95 The Magpie RSS Parser and Atom Parser codebase courtesy of http://magpierss.sf.net
97 Trackback codebase contributed by Dougal Campbell - http://dougal.gunters.org
98 Pingback code based on pingback implementation for b2 - http://www.cafelog.com
100 Simplog development team:
101 f-bomb - http://www.webhack.com
102 jbuberel - http://www.buberel.org