EduBlog Instructions: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
m (Reverted edits by 201.6.3.241 (Talk) to last version by 140.180.20.121)
 
(46 intermediate revisions by 4 users not shown)
Line 2: Line 2:
| [[EduBlog_Instructions|english]] | [[EduBlog_Instructions/lang-es|español]] }}
| [[EduBlog_Instructions|english]] | [[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>
==For Those With Build 656==
This page is still too technical for testing.
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.

==Pages for Testing==
If you'd like an account to test the system, please contact [[User:tarun2000|Tarun]].
<br />
<b>For Teachers (username: teacher or teacheres):</b>
*[http://edublog.venango.org/EduBlog/moodle/course/modedit.php?add=oublog&type=&course=3&section=0&return=0 Create New Blog]
*[http://edublog.venango.org/EduBlog/moodle/mod/oublog/view.php?id=7 View/Manage Blog] - (already created for demo)
*[http://uruguay-xo-test.blogspot.com Remote "Linked" Blog]

<b>For Students (username: student or studentes):</b>
*[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)
*[http://edublog.venango.org/EduBlog/moodle/mod/oublog/editpost.php?blog=4 New Blog Post] - (blog already created for demo)
*[http://uruguay-xo-test.blogspot.com 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, [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.

===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]]
[[Image:Tarun2000_usecase_t1_6_en.png|thumb|400px|left|Enter Blog Name and Blog Summary - the summary can be formatted and contain images]]
[[Image:Tarun2000_usecase_t1_7_en.png|thumb|400px|left|Here we select the Remote Blog Settings (Mirror Local and Remote) and disable Teacher Review. Common Module Settings will be hidden from the UI]]
[[Image:Tarun2000_usecase_t1_8_en.png|thumb|400px|left|The new blog is shown (no posts made yet)]]

<div style="clear:both">&nbsp;</div>

===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. 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"]]
[[Image:Tarun2000_usecase_s1_6_en.png|thumb|400px|left|Go back to BrowseNew]]
[[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"]]<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]]

<div style="clear:both">&nbsp;</div>

===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]]
[[Image:Tarun2000_usecase_s2_2_en.png|thumb|400px|left|Take a picture and copy it to the clipboard]]
[[Image:Tarun2000_usecase_s2_3_en.png|thumb|400px|left|Open WriteNew]]
[[Image:Tarun2000_usecase_s2_4_en.png|thumb|400px|left|Write some text and paste the image]]
[[Image:Tarun2000_usecase_s2_5_en.png|thumb|400px|left|Keep the Entry (no special format)]]
[[Image:Tarun2000_usecase_s2_6_en.png|thumb|400px|left|Open BrowseNew]]
[[Image:Tarun2000_usecase_s2_7_en.png|thumb|400px|left|Goto the New Blog Post Page and enter a title]]
[[Image:Tarun2000_usecase_s2_8_en.png|thumb|400px|left|From the Edit toolbar in the Editor, click the Write Upload icon]]
[[Image:Tarun2000_usecase_s2_9_en.png|thumb|400px|left|Select the Blog Post]]
[[Image:Tarun2000_usecase_s2_10_en.png|thumb|400px|left|Add extra text and clean up the blog post as needed]]
[[Image:Tarun2000_usecase_s2_11_en.png|thumb|400px|left|Enter tags and click "Add Blog Post"]]
[[Image:Tarun2000_usecase_s2_12_en.png|thumb|400px|left|The post appears on the local Moodle Blog]]
[[Image:Tarun2000_usecase_s2_13_en.png|thumb|400px|left|The post is also sent automatically to Blogger.com]]

<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>
<h3>New Blog Settings Explained</h3>
[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
*Blog Name: Local name of the blog
*Summary: The description of the blog assignment that appears when students try to create a blog post
*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
*Allow Comments: Whether students and teachers can comment on the blog posts
*Maximum Visibility: Determines who can see the local blog
*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
*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
*Manage Remote Blog: Links to manage remote blog page - still has bugs, do not use yet
*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
*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
*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>
<h3>Posting to a Blog Explained</h3>
[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)
*Title: The title of the blog post
*Title: The title of the blog post
*Message: The contents of the blog post (the editor mimic's Write, so hopefully no doc needed?)
*Message: The contents of the blog post (the editor mimic's Write, so hopefully no doc needed?)
Line 25: Line 103:


<h3>Managing a Blog</h3>
<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>
Some of these options appear under each post
*Edit: Allows the blog post to be edited
*Edit: Allows the blog post to be edited
*Delete: Deletes the blog post
*Delete: Deletes the blog post
Line 33: Line 109:
*Add Your Comment: Allows for commenting on post
*Add Your Comment: Allows for commenting on post


<h2>Use Cases</h2>
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.

<h3>Teacher Creates a New Blog</h3>
[[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]]
[[Image:Tarun2000_usecase_t1_6_en.png|thumb|400px|left|Enter Blog Name and Blog Summary - the summary can be formatted and contain images]]
[[Image:Tarun2000_usecase_t1_7_en.png|thumb|400px|left|Here we select the Remote Blog Settings (Mirror Local and Remote) and disable Teacher Review. Common Module Settings will be hidden from the UI]]
[[Image:Tarun2000_usecase_t1_8_en.png|thumb|400px|left|The new blog is shown (no posts made yet)]]

<div style="clear:both">&nbsp;</div>

<h3>Student Posts to Blog with an Image using BrowseNew and Record</h3>
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 (this needs to be linked to from a gateway page)]]
[[Image:Tarun2000_usecase_s1_3_en.png|thumb|400px|left|Enter the title and write some content for the post]]
[[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"]]
[[Image:Tarun2000_usecase_s1_6_en.png|thumb|400px|left|Go back to BrowseNew]]
[[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]]
[[Image:Tarun2000_usecase_s1_9_en.png|thumb|400px|left|]]
[[Image:Tarun2000_usecase_s1_10_en.png|thumb|400px|left|]]
[[Image:Tarun2000_usecase_s1_11_en.png|thumb|400px|left|]]

<div style="clear:both">&nbsp;</div>

<h3>Student Posts to Blog by Write Upload</h3>


[[Category: Educational Blogger Project]]
[[Category: Educational Blogger Project]]

Latest revision as of 07:53, 17 December 2008

   english | español 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):

For Students (username: student or studentes):

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