EduBlog Instructions: Difference between revisions

Latest revision as of 07:53, 17 December 2008

HowTo [ID# 187623]

This page is to guide beta testers through the EduBlog features that need testing and will hopefully eventually be improved into being a decent guide. Please try out the workflows in the use cases.

For Those With Build 656

Those using build 656 (not 656 update 1) will need to install a patched version of Browse and Write in order to insert images or upload from Write. These patched versions are BrowseNew and WriteNew and will install along side the existing Browse and Write activities on the XO. The icons are black and have a star on top of the standard sugar icon. Do not try these patches unless you are absolutely sure you are using build 656 prior to update 1. It is also recommended that those using build 656 eventually upgrade their builds and use the newer versions of the activities which have been fixed.

Pages for Testing

If you'd like an account to test the system, please contact Tarun.
For Teachers (username: teacher or teacheres):

Create New Blog
View/Manage Blog - (already created for demo)
Remote "Linked" Blog

For Students (username: student or studentes):

List of Blogs
View Blog - (blog already created for demo)
New Blog Post - (blog already created for demo)
Remote "Linked" Blog

Use Cases

The following use cases demonstrate EduBlog's basic features. All images are actual screenshots taking on an XO-1 with Build 656 running BrowseNew and WriteNew. It is assumed that the admin or teacher has already entered the settings for EduBlog to connect to the remote blogs. Moodle EduBlog, commit from August 6, 2008, was locally run on Ubuntu with LAMPP and AbiWord 2.6.0 since the main server was down. Some screenshots were edited to make this guide easier to follow.

Teacher Creates a New Blog

Open BrowseNew - BrowseNew's icon will not pulse, so please be patient for it to load

Goto The Create New Blog Link - please note you may need to enter your username and password if this is the first time you are visiting EduBlog

Enter Blog Name and Blog Summary - the summary can be formatted and contain images

Here we select the Remote Blog Settings (Mirror Local and Remote) and disable Teacher Review. Common Module Settings will be hidden from the UI

The new blog is shown (no posts made yet)

Student Posts to Blog with an Image using Browse and Record

The teacher configured this blog to post to uruguay-xo-test with the settings "Mirror Local and Remote" and "Disable Teacher Review".

Open BrowseNew and goto the post blog page

Enter the title and write some content for the post. Then click "Image"

Open Record

Take a picture, hover over the image in the bottom toolbar and click "Copy to Clipboard"

Go back to BrowseNew

From the frame, hover over the clipping and select "Add to Journal"

Click "Image" in the Editor and then the upload image icon
Select the clipping from the file upload dialog

Click "Add Blog Post"

The post appears locally in Moodle Blog

The post is automatically sent to the remote blog

Student Posts to Blog with an Image using Write Upload

The teacher configured this blog to post to uruguay-xo-test with the settings "Mirror Local and Remote" and "Disable Teacher Review".

Open Record

Take a picture and copy it to the clipboard

Open WriteNew

Write some text and paste the image

Keep the Entry (no special format)

Open BrowseNew

Goto the New Blog Post Page and enter a title

From the Edit toolbar in the Editor, click the Write Upload icon

Select the Blog Post

Add extra text and clean up the blog post as needed

Enter tags and click "Add Blog Post"

The post appears on the local Moodle Blog

The post is also sent automatically to Blogger.com

Student Sends Post to Teacher for Approval

The following screenshots are from the August 10, 2008 commit. The teacher has selected "Require Teacher Approval" as the Teacher Approval setting.

Goto the New Blog Post Page

Create a Blog Entry and Click Add to Blog. Notice the "Send To:" option says "Teacher"

The post is visible only to the student who posted it and the teacher. It is blue to indicate it has not been approved.

Teacher Approves Posts

Goto the blog and click "Approve"

The post turns white to indicate it is public

The post is automatically sent to Blogger.com

EduBlog Settings

New Blog Settings Explained

Blog Name: Local name of the blog
Summary: The description of the blog assignment that appears when students try to create a blog post
Allow Comments: Whether students and teachers can comment on the blog posts
Maximum Visibility: Determines who can see the local blog
Remote Blog Type: Determines which external blog (ie Blogger.com) to link to; "Local Only" means not to link to any other blog
Name: The name of your Blogger.com blog
Username: Your google username
Password: Your google password
Synchronization Style: Determines how this blog links to the external blog; "Require Teacher Publishing" means that the ONLY way a post goes to the external blog is if a teacher or admin logs in visits the view page and clicks the publish option for that post; Mirror Local and Remote means that any posts that are visible to students in the local blog are automatically also published to the remote blog
Teacher Review Style: Determines whether and how to use teacher review; "Disable Teacher Review" forces all posts to directly go to the blog; "Allow Teacher Review" gives students the option to send to teacher for approval or directly send to the blog; "Require Teacher Review" forces students to send to the teacher for approval before the post appears to other students; The post being published to the external blog depends on the "Synchronization Style" setting

Posting to a Blog Explained

Title: The title of the blog post
Message: The contents of the blog post (the editor mimic's Write, so hopefully no doc needed?)
Tags: Words or short phrases describing the post's content
Send To: Indicates whether to send to teacher or directly to the blog; The visible options depend on how the teacher configures the blog

Managing a Blog

Edit: Allows the blog post to be edited
Delete: Deletes the blog post
Publish: Sends the post to the remote blog (shows if Synchronization Style is set to "Require Teacher Publishing")
Approve: Allows teachers to approve posts that used the send to teacher (shows if "Disable Teacher Review" is not selected)
Add Your Comment: Allows for commenting on post

@@ Line 2: / Line 2: @@
   | [[EduBlog_Instructions|english]] &#124; [[EduBlog_Instructions/lang-es|español]] }}
+This page is to guide beta testers through the [[Educational Blogger Project|EduBlog]] features that need testing and will hopefully eventually be improved into being a decent guide.  Please try out the workflows in the use cases.
-<h2>EduBlog Guide</h2>
-<h3>Setting Up Remote Blogs</h3>
-This page is still too technical for testing.
+==For Those With Build 656==
-<h3>New Blog Settings Explained</h3>
+Those using build 656 (not 656 update 1) will need to install a patched version of Browse and Write in order to insert images or upload from Write.  These patched versions are [[Media:BrowseNew-2.xo|BrowseNew]] and [[Media:WriteNew-1.xo|WriteNew]] and will install along side the existing Browse and Write activities on the XO.  The icons are black and have a star on top of the standard sugar icon.  Do not try these patches unless you are absolutely sure you are using build 656 prior to update 1.  It is also recommended that those using build 656 eventually upgrade their builds and use the newer versions of the activities which have been fixed.
-[http://edublog.venango.org/test/EduBlog/moodle/course/modedit.php?add=oublog&type=&course=2&section=0&return=0 Try Creating a New Blog]: Username - teacher (english) or teacheres (espanol)
-*Blog Name: Local name of the blog
-*Summary: The description of the blog assignment that appears when students try to create a blog post
-*Allow Comments: Whether students and teachers can comment on the blog posts
-*Maximum Visibility: Determines who can see the local blog
-*Select Remote Blog: Determines which external blog (ie Blogger.com) to link to; "Local Only" means not to link to any other blog
-*Manage Remote Blog: Links to manage remote blog page - still has bugs, do not use yet
-*Synchronization Style: Determines how this blog links to the external blog; "Require Teacher Publishing" means that the ONLY way a post goes to the external blog is if a teacher or admin logs in visits the view page and clicks the publish option for that post; Mirror Local and Remote means that any posts that are visible to students in the local blog are automatically also published to the remote blog
-*Teacher Review Style: Determines whether and how to use teacher review; "Disable Teacher Review" forces all posts to directly go to the blog; "Allow Teacher Review" gives students the option to send to teacher for approval or directly send to the blog; "Require Teacher Review" forces students to send to the teacher for approval before the post appears to other students; The post being published to the external blog depends on the "Synchronization Style" setting
+==Pages for Testing==
-<h3>Posting to a Blog Explained</h3>
+If you'd like an account to test the system, please contact [[User:tarun2000|Tarun]].
-[http://edublog.venango.org/test/EduBlog/moodle/mod/oublog/editpost.php?blog=2  Try Posting to a New Blog]: Username - student (english) or studentes (espanol)
+<br />
-*Title: The title of the blog post
+<b>For Teachers (username: teacher or teacheres):</b>
-*Message: The contents of the blog post (the editor mimic's Write, so hopefully no doc needed?)
+*[http://edublog.venango.org/EduBlog/moodle/course/modedit.php?add=oublog&type=&course=3&section=0&return=0 Create New Blog]
-*Tags: Words or short phrases describing the post's content
+*[http://edublog.venango.org/EduBlog/moodle/mod/oublog/view.php?id=7 View/Manage Blog] - (already created for demo)
-*Send To: Indicates whether to send to teacher or directly to the blog; The visible options depend on how the teacher configures the blog
+*[http://uruguay-xo-test.blogspot.com Remote "Linked" Blog]
+<b>For Students (username: student or studentes):</b>
-<h3>Managing a Blog</h3>
-[http://edublog.venango.org/test/EduBlog/moodle/mod/oublog/view.php?id=3 Try Managing a Blog]: Username - teacher (english) or teacheres (espanol)<br>
+*[http://edublog.venango.org/EduBlog/moodle/mod/oublog/index.php?id=3 List of Blogs]
+*[http://edublog.venango.org/EduBlog/moodle/mod/oublog/view.php?id=7 View Blog] - (blog already created for demo)
-Some of these options appear under each post
+*[http://edublog.venango.org/EduBlog/moodle/mod/oublog/editpost.php?blog=4 New Blog Post] - (blog already created for demo)
-*Edit: Allows the blog post to be edited
+*[http://uruguay-xo-test.blogspot.com Remote "Linked" Blog]
-*Delete: Deletes the blog post
-*Publish: Sends the post to the remote blog (shows if Synchronization Style is set to "Require Teacher Publishing")
-*Approve: Allows teachers to approve posts that used the send to teacher (shows if "Disable Teacher Review" is not selected)
-*Add Your Comment: Allows for commenting on post
-<h2>Use Cases</h2>
+==Use Cases==
-The following use cases demonstrate EduBlog's basic features.  All images are actual screenshots taking on an XO-1 with Build 656 running BrowseNew and WriteNew (patched for broken objectchooser.py).  It is also assumed that the admin or teacher has already entered the settings for EduBlog to connect to the remote blogs.  Some images were edited to make this guide easier to follow.  Moodle EduBlog, commit 	a8a4bad89c66ec802ae80e50c1e87b0061861640, was locally run on Ubuntu with LAMPP since the main server was down.
+The following use cases demonstrate EduBlog's basic features.  All images are actual screenshots taking on an XO-1 with Build 656 running BrowseNew and WriteNew.  It is assumed that the admin or teacher has already entered the settings for EduBlog to connect to the remote blogs.  Moodle EduBlog, [http://dev.laptop.org/git?p=projects/EduBlog;a=commit;h=ea0031afab210419b86a5c4c058b5e750cc167ee commit from August 6, 2008], was locally run on Ubuntu with LAMPP and AbiWord 2.6.0 since the main server was down.  Some screenshots were edited to make this guide easier to follow.
-<h3>Teacher Creates a New Blog</h3>
+===Teacher Creates a New Blog===
 [[Image:Tarun2000_usecase_t1_1_en.png|thumb|400px|left|Open BrowseNew - BrowseNew's icon will not pulse, so please be patient for it to load]]
 [[Image:Tarun2000_usecase_t1_3_en.png|thumb|400px|left|Goto The Create New Blog Link - please note you may need to enter your username and password if this is the first time you are visiting EduBlog]]
@@ Line 45: / Line 33: @@
 <div style="clear:both">&nbsp;</div>
-<h3>Student Posts to Blog with an Image using BrowseNew and Record</h3>
+===Student Posts to Blog with an Image using Browse and Record===
 The teacher configured this blog to post to uruguay-xo-test with the settings "Mirror Local and Remote" and "Disable Teacher Review".
 [[Image:Tarun2000_usecase_s1_1_en.png|thumb|400px|left|Open BrowseNew and goto the post blog page]]
-[[Image:Tarun2000_usecase_s1_3_en.png|thumb|400px|left|Enter the title and write some content for the post<br>]]
+[[Image:Tarun2000_usecase_s1_3_en.png|thumb|400px|left|Enter the title and write some content for the post.  Then click "Image"<br>]]
 [[Image:Tarun2000_usecase_s1_4_en.png|thumb|400px|left|Open Record]]
 [[Image:Tarun2000_usecase_s1_5_en.png|thumb|400px|left|Take a picture, hover over the image in the bottom toolbar and click "Copy to Clipboard"]]
@@ Line 54: / Line 42: @@
 [[Image:Tarun2000_usecase_s1_7_en.png|thumb|400px|left|From the frame, hover over the clipping and select "Add to Journal"]]
 [[Image:Tarun2000_usecase_s1_8_en.png|thumb|400px|left|Click "Image" in the Editor and then the upload image icon<br />Select the clipping from the file upload dialog]]
-[[Image:Tarun2000_usecase_s1_9_en.png|thumb|400px|left|Click "Add Blog Post"]]
+[[Image:Tarun2000_usecase_s1_9_en.png|thumb|400px|left|Click "Add Blog Post"]]<div style="clear:both">&nbsp;</div>
 [[Image:Tarun2000_usecase_s1_10_en.png|thumb|400px|left|The post appears locally in Moodle Blog]]
 [[Image:Tarun2000_usecase_s1_11_en.png|thumb|400px|left|The post is automatically sent to the remote blog]]
@@ Line 60: / Line 48: @@
 <div style="clear:both">&nbsp;</div>
-<h3>Student Posts to Blog by Write Upload</h3>
+===Student Posts to Blog with an Image using Write Upload===
 The teacher configured this blog to post to uruguay-xo-test with the settings "Mirror Local and Remote" and "Disable Teacher Review".
 [[Image:Tarun2000_usecase_s2_1_en.png|thumb|400px|left|Open Record]]
@@ Line 77: / Line 65: @@
 <div style="clear:both">&nbsp;</div>
+===Student Sends Post to Teacher for Approval===
+The following screenshots are from the [http://dev.laptop.org/git?p=projects/EduBlog;a=commit;h=0a65b8eda9ce6f34182467bf3018c7410720c3eb August 10, 2008 commit].  The teacher has selected "Require Teacher Approval" as the Teacher Approval setting.
+[[Image:Tarun2000_usecase_s3_1_en.png|thumb|400px|left|Goto the New Blog Post Page]]
+[[Image:Tarun2000_usecase_s3_2_en.png|thumb|400px|left|Create a Blog Entry and Click Add to Blog.  Notice the "Send To:" option says "Teacher"]]
+[[Image:Tarun2000_usecase_s3_3_en.png|thumb|400px|left|The post is visible only to the student who posted it and the teacher.  It is blue to indicate it has not been approved.]]
+<div style="clear:both">&nbsp;</div>
+===Teacher Approves Posts===
+[[Image:Tarun2000_usecase_t2_1_en.png|thumb|400px|left|Goto the blog and click "Approve"]]
+[[Image:Tarun2000_usecase_t2_2_en.png|thumb|400px|left|The post turns white to indicate it is public]]
+[[Image:Tarun2000_usecase_t2_3_en.png|thumb|400px|left|The post is automatically sent to Blogger.com]]
+<div style="clear:both">&nbsp;</div>
+==EduBlog Settings==
+<h3>New Blog Settings Explained</h3>
+*Blog Name: Local name of the blog
+*Summary: The description of the blog assignment that appears when students try to create a blog post
+*Allow Comments: Whether students and teachers can comment on the blog posts
+*Maximum Visibility: Determines who can see the local blog
+*Remote Blog Type: Determines which external blog (ie Blogger.com) to link to; "Local Only" means not to link to any other blog
+*Name: The name of your Blogger.com blog
+*Username: Your google username
+*Password: Your google password
+*Synchronization Style: Determines how this blog links to the external blog; "Require Teacher Publishing" means that the ONLY way a post goes to the external blog is if a teacher or admin logs in visits the view page and clicks the publish option for that post; Mirror Local and Remote means that any posts that are visible to students in the local blog are automatically also published to the remote blog
+*Teacher Review Style: Determines whether and how to use teacher review; "Disable Teacher Review" forces all posts to directly go to the blog; "Allow Teacher Review" gives students the option to send to teacher for approval or directly send to the blog; "Require Teacher Review" forces students to send to the teacher for approval before the post appears to other students; The post being published to the external blog depends on the "Synchronization Style" setting
+<h3>Posting to a Blog Explained</h3>
+*Title: The title of the blog post
+*Message: The contents of the blog post (the editor mimic's Write, so hopefully no doc needed?)
+*Tags: Words or short phrases describing the post's content
+*Send To: Indicates whether to send to teacher or directly to the blog; The visible options depend on how the teacher configures the blog
+<h3>Managing a Blog</h3>
+*Edit: Allows the blog post to be edited
+*Delete: Deletes the blog post
+*Publish: Sends the post to the remote blog (shows if Synchronization Style is set to "Require Teacher Publishing")
+*Approve: Allows teachers to approve posts that used the send to teacher (shows if "Disable Teacher Review" is not selected)
+*Add Your Comment: Allows for commenting on post
 [[Category: Educational Blogger Project]]

EduBlog Instructions: Difference between revisions

Latest revision as of 07:53, 17 December 2008

Contents

For Those With Build 656

Pages for Testing