https://wiki.mahara.org/api.php?action=feedcontributions&user=WikiSysop&feedformat=atomMahara Wiki - User contributions [en]2019-01-21T20:48:38ZUser contributionsMediaWiki 1.27.1https://wiki.mahara.org/index.php?title=Mahara_Wiki&diff=1233Mahara Wiki2011-05-13T00:02:55Z<p>WikiSysop: </p>
<hr />
<div>'''Welcome to the Mahara Wiki! To edit pages here, you need a '''[http://mahara.org/register.php '''mahara.org account''']'''. Then you can '''[[Special:Userlogin|'''sign in to the wiki''']]''' using the same username and password details.'''<br />
<br />
If you have a question that is not answered by the wiki, you can ask about it in the [http://mahara.org/forums forums]. And if you want to add content, please feel free! You may want to ask in the forums to check if you're adding something in the right place or that it's not already documented first, if you're not sure.<br />
<br />
If you want help using the wiki, there is a user manual available ([http://www.mindtouch.com/User_Manual browse online], [http://www.mindtouch.com/@api/deki/files/915/=User_Manual.pdf PDF]).<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Quick Links===<br />
<br />
* [[Download Mahara]][[Download Mahara#Language Packs|&lt;br /&gt;]]<br />
* [[Language Packs]]<br />
* Instructions on [[System Administrator's Guide/Installing Mahara|Installing Mahara]], or [[System Administrator's Guide/Upgrading Mahara|Upgrading Mahara]]. [[Release Notes|Release notes]] for each release are available.<br />
* [[User Guide|User Manual]] - how to use Mahara, for students and staff.<br />
* [[Customising|Customising Mahara]] - [[Customising/Themes|themes]], [[plugins]] etc., and [[Developer Area|Developer Documentation]] if you're wanting to understand/write plugins for Mahara.<br />
* [[System Administrator's Guide/Moodle%2f%2fMahara Integration|Mahara-Moodle ]]integration guide.<br />
* Need [[Support]]? Or want to [[Contributing to Mahara|contribute to Mahara]]?<br />
* The [[Roadmap]] - detailing plans for future development.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Mahara Elsewhere===<br />
<br />
* [http://groups.diigo.com/group/everything-mahara Diigo]<br />
* [http://gitorious.org/mahara Gitorious] <br />
* [http://groups.google.com/group/mahara-users Google Group Mahara-Users] (primarily Japanese)<br />
* [http://identi.ca/maharaproject Identica account] and [http://identi.ca/group/mahara group]<br />
* [https://www.launchpad.net/mahara Launchpad]<br />
* [http://www.linkedin.com/groups?mostPopular=&amp;gid=2037561 LinkedIn]<br />
* [http://www.ohloh.net/p/mahara Ohloh]<br />
* [http://www.openhatch.org/+projects/mahara OpenHatch]<br />
* [http://www.slideshare.net/tag/mahara Slideshare]<br />
* [http://twitter.com/maharaproject Twitter]<br />
<br />
&lt;center&gt;[http://creativecommons.org/licenses/by-sa/3.0/ https://i.creativecommons.org/l/by-sa/3.0/88x31.png]&lt;br /&gt; This wiki is licensed under a [http://creativecommons.org/licenses/by-sa/3.0/ Creative Commons Attribution-ShareAlike 3.0 Unported License].&lt;/center&gt;&lt;/div&gt;<br />
<br />
===Subpages===<br />
<br />
* [[BasicPHPFileTemplates|BasicPHPFileTemplates]]<br />
* [[Contributing_to_Mahara|Contributing to Mahara]]<br />
* [[Contributors|Mahara Team and Contributors]]<br />
* [[Customising|Customising]]<br />
* [[Developer_Area|Developer Area]]<br />
* [[Documentación_en_Español|Documentación en Español]]<br />
* [[Documentation_en_français|Mahara - en français]]<br />
* [[Download_Mahara|Download Mahara]]<br />
* [[Guia_de_l'usuari::cat|Documentació_cat]]<br />
* [[History|History]]<br />
* [[Institute_administrator_guide|Institute administrator guide]]<br />
* [[Language_Packs|Language Packs]]<br />
* [[Mahara.org_forums_-_Code_of_Conduct|Mahara.org forums - Code of Conduct (Work in Progress)]]<br />
* [[Mahara_Video_Script|Mahara Video]]<br />
* [[Mahara日本語ドキュメント|Mahara日本語ドキュメント]]<br />
* [[Marketing|Marketing]]<br />
* [[Plugins|Plugins]]<br />
* [[Release_Notes|Release Notes]]<br />
* [[Roadmap|Roadmap]]<br />
* [[Site_Administrator_Guide|Site Administrator Guide]]<br />
* [[Support|Support]]<br />
* [[System_Administrator's_Guide|System Administrator's Guide]]<br />
* [[Themes|Themes]]<br />
* [[User_Guide|User Guide]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=BasicPHPFileTemplates&diff=1232BasicPHPFileTemplates2011-05-12T22:54:56Z<p>WikiSysop: </p>
<hr />
<div>These are the templates for all new PHP files. There is a different template depending on whether you file is able to be publicly hittable or not. The templates are available in &lt;code&gt;/examples&lt;/code&gt; in version control, and should be considered the most up to date versions of these files.<br />
<br />
This project uses PHPDoc for API documentation. This project is also licensed under the GPL, which causes some header bloat (it is a requirement of licensing your program under the GPL, see [http://www.gnu.org/copyleft/gpl.html &lt;span style=&quot;white-space: nowrap&quot;&gt;http://www.gnu.org/copyleft/gpl.html&lt;/span&gt;] ).<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Template for files you expect to be hit by visitors===<br />
<br />
.<br />
*<br />
* @package mahara<br />
* @subpackage core<br />
* @author Firstname Lastname<br />
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL<br />
* @copyright (C) 2010 Firstname Lastname<br />
*<br />
*/<br />
<br />
define('INTERNAL', 1);<br />
require('init.php');<br />
<br />
// Your code here :)<br />
<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Template for files you do NOT want to be hit by visitors===<br />
<br />
.<br />
*<br />
* @package mahara<br />
* @subpackage core or plugintype/pluginname<br />
* @author Firstname Lastname<br />
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL<br />
* @copyright (C) 2010 Firstname Lastname<br />
*<br />
*/<br />
<br />
defined('INTERNAL') || die();<br />
require('init.php');<br />
<br />
// Your code here :)<br />
<br />
<br />
'''Notes:'''<br />
<br />
* Omit the closing php tag &quot;?&amp;gt;&quot;<br />
* Catalyst employees should assign copyright to &quot;Catalyst IT Ltd [http://catalyst.net.nz/ &lt;span style=&quot;white-space: nowrap&quot;&gt;http://catalyst.net.nz&lt;/span&gt;]&quot;, if they are working on the project in company time.<br />
<br />
&lt;/div&gt;</div>WikiSysophttps://wiki.mahara.org/index.php?title=BasicPHPFileTemplates&diff=1231BasicPHPFileTemplates2011-05-12T22:54:22Z<p>WikiSysop: </p>
<hr />
<div>These are the templates for all new PHP files. There is a different template depending on whether you file is able to be publicly hittable or not. The templates are available in &lt;code&gt;/examples&lt;/code&gt; in version control, and should be considered the most up to date versions of these files.<br />
<br />
This project uses PHPDoc for API documentation. This project is also licensed under the GPL, which causes some header bloat (it is a requirement of licensing your program under the GPL, see [http://www.gnu.org/copyleft/gpl.html &lt;span style=&quot;white-space: nowrap&quot;&gt;http://www.gnu.org/copyleft/gpl.html&lt;/span&gt;] ).<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Template for files you expect to be hit by visitors===<br />
<br />
.<br />
*<br />
* @package mahara<br />
* @subpackage core<br />
* @author Firstname Lastname<br />
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL<br />
* @copyright (C) 2010 Firstname Lastname<br />
*<br />
*/<br />
<br />
define('INTERNAL', 1);<br />
require('init.php');<br />
<br />
// Your code here :)<br />
<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Template for files you do NOT want to be hit by visitors===<br />
<br />
.<br />
*<br />
* @package mahara<br />
* @subpackage core or plugintype/pluginname<br />
* @author Firstname Lastname<br />
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL<br />
* @copyright (C) 2010 Firstname Lastname<br />
*<br />
*/<br />
<br />
defined('INTERNAL') || die();<br />
require('init.php');<br />
<br />
// Your code here :)<br />
<br />
<br />
'''Notes:'''<br />
<br />
* Omit the closing php tag &quot;?&amp;gt;&quot;<br />
* Catalyst employees should assign copyright to &quot;Catalyst IT Ltd [http://catalyst.net.nz/ &lt;span style=&quot;white-space: nowrap&quot;&gt;[[Image:http.png]]http://catalyst.net.nz&lt;/span&gt;]&quot;, if they are working on the project in company time.<br />
<br />
&lt;/div&gt;</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/User_Guide_As_One_Page/User_cheat_sheet&diff=1230User Guide/User Guide As One Page/User cheat sheet2011-05-12T05:51:39Z<p>WikiSysop: </p>
<hr />
<div>Mahara portfolios are made up of artefacts gathered into views. You decide who can see each view by setting access&lt;br /&gt; Artefacts are blocks of text, images, documents, videos, blog entries and any other media you import.<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Edit profile===<br />
<br />
[[Image:mahara%20profile.jpg.jpeg|mahara profile.jpg.jpeg]]<br />
<br />
&lt;br /&gt;<br />
<br />
{| width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:mahara%20edit%20profile.jpeg|mahara edit profile.jpeg]]<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:mahara%20my%20resume.jpeg|mahara my resume.jpeg]]<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Editing your Profile and Profile page'''<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''My Resumé, My Goals, My Skills'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
The profile section of mahara is where you enter your personal information, contact details and upload images to use as a profile picture. Each of the tabs in this section lets you add more information so that others can get to know you better. You can also change the way the page displays by dragging items around to define the layout.&lt;br /&gt;<br />
| width=&quot;250&quot; valign=&quot;top&quot; | Clicking on each item brings you to a page with a text editor. You can enter information about your aspirations and past achievements.&lt;br /&gt; The text editor sections work just like a word processor, you can cut and paste things from other applications, change the font and add pictures. You can even switch to HTML mode.&lt;br /&gt;<br />
|}<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Create Views===<br />
<br />
[[Image:mahara%20my%20views%20menu.jpeg|mahara my views menu.jpeg]]<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;5&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:build%20protfolio.jpeg|build protfolio.jpeg]]<br />
|<br />
[[Image:build2.jpeg|build2.jpeg]]<br />
|<br />
[[Image:build3.jpeg|build3.jpeg]]<br />
|-<br />
| '''Building A Portfolio'''<br />
| '''Give it a name '''<br />
| '''Setting Access'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | The first part of building a View is deciding what goes in it and how it will be displayed. Under each of these tabs are content types that you can drag and drop in any order. A View&lt;br /&gt; can contain files such as images, blog posts, links to internet resources such as video. Use My Files and My Blogs link to create these before you can use them in your view.&lt;br /&gt;<br />
| width=&quot;250&quot; valign=&quot;top&quot; | Your next step is to give your View a name and a short description. This&lt;br /&gt; helps people find it and understand what it is.&lt;br /&gt;&lt;br /&gt;<br />
| width=&quot;250&quot; valign=&quot;top&quot; | You now decide who gets to see&lt;br /&gt; your View. You can choose to restrict access to just some friends, groups, your teachers, all users, or even non-&lt;br /&gt; mahara users. Beside every option is an Add button. Click that and your selection will move to the right hand side of the page. You can also set&lt;br /&gt; access start and stop dates, so if you want a View to only be available for one semester, or even a week, you can do that.&lt;br /&gt;&lt;br /&gt;<br />
|}<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
===Groups===<br />
<br />
[[Image:groups%20menu.jpeg|groups menu.jpeg]]<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;5&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:groups.jpeg|groups.jpeg]]<br />
|<br />
[[Image:groups%20create.jpeg|groups create.jpeg]]<br />
|<br />
[[Image:groups%20manage.jpeg|groups manage.jpeg]]<br />
|-<br />
| '''My Groups/Find Groups&lt;br /&gt;'''<br />
| '''Create Group '''<br />
| '''Group Management'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | From this section you can see groups you've already joined as well as those you've started, been invited to and have asked to join. You can aslo search for groups that you may want to join&lt;br /&gt;<br />
| width=&quot;250&quot; valign=&quot;top&quot; | By clicking the Create Group button you can start your own groups. There are a number of different group types, the basic difference is how members join. Click on the help icon next to the&lt;br /&gt; Group Type dropdown menu to find out what kinds of groups there are.&lt;br /&gt;<br />
| width=&quot;250&quot; valign=&quot;top&quot; | Use this section to find out more abouta group. Who’s in it, what they are disccussing and download any files related to the group. Simply click on the group’s name and you will find out this information.&lt;br /&gt;<br />
|}<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_4&quot;&gt;<br />
<br />
===Settings===<br />
<br />
[[Image:Mahara%20home%20menu.jpg|Mahara home menu.jpg]]<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;5&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:Preferences.jpeg|Preferences.jpeg]]<br />
|<br />
[[Image:ActivityPrefs.jpg|ActivityPrefs.jpg]]<br />
|<br />
[[Image:notification.jpeg|notification.jpeg]]<br />
|-<br />
| '''Preferences&lt;br /&gt;'''<br />
| '''Notifications'''<br />
| '''Activity preferences&lt;br /&gt;'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This section allows you to reset your username and password as well as set up general behaviour rules for your entire account. Things like how friend requests and messages from other users will be handled and set here.&lt;br /&gt;<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This is similar to the inbox in your email system. Here you'll find every message and notification that's been sent to you. Like any inbox you can delete, organise, and reply from here.&lt;br /&gt;<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This section controls how you'll get notifications from other users, groups and your friends. You can set it so you can get email on your regular account, an email digest or so you have to go into mahara to view your messages and notifications.&lt;br /&gt;<br />
|}<br />
<br />
[[Image:mahara%20buttons.jpeg|mahara buttons.jpeg]]<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Activityprefs.jpg]]<br />
*[[File:Build_protfolio.jpeg]]<br />
*[[File:Build2.jpeg]]<br />
*[[File:Build3.jpeg]]<br />
*[[File:Groups.jpeg]]<br />
*[[File:Groups_create.jpeg]]<br />
*[[File:Groups_manage.jpeg]]<br />
*[[File:Groups_menu.jpeg]]<br />
*[[File:Mahara_buttons.jpeg]]<br />
*[[File:Mahara_edit_profile.jpeg]]<br />
*[[File:Mahara_home_menu.jpg]]<br />
*[[File:Mahara_my_resume.jpeg]]<br />
*[[File:Mahara_my_views_menu.jpeg]]<br />
*[[File:Mahara_preferences.jpg.jpeg]]<br />
*[[File:Mahara_profile.jpg.jpeg]]<br />
*[[File:Mahara_step_1.jpeg]]<br />
*[[File:Notification.jpeg]]<br />
*[[File:Preferences.jpeg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/User_Guide_As_One_Page/Mahara//Moodle_outcomes_micro_manual&diff=1229User Guide/User Guide As One Page/Mahara//Moodle outcomes micro manual2011-05-12T05:51:32Z<p>WikiSysop: </p>
<hr />
<div>This requires the Mahoodle single signon to be installed.<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:admin.png|admin.png]]<br />
|<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Setup outcomes:===<br />
<br />
&lt;br /&gt; Enable outcomes: Grades &amp;gt; General Settings &amp;gt; Enable outcomes&lt;br /&gt; Add standard outcomes: Grades &amp;gt; Outcomes &amp;gt; Add new outcome&lt;br /&gt; Add/edit standard scales: Grades &amp;gt; scales &amp;gt; add/edit new scale<br />
<br />
&lt;/div&gt;<br />
|}<br />
<br />
[[Image:enable%20outcomes.png|enable outcomes.png]]<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:teacher.png|teacher.png]]<br />
|<br />
&lt;font size=&quot;medium&quot;&gt;'''Create Assessments: '''&lt;/font&gt;<br />
<br />
&lt;br /&gt; Define outcomes: Administration &amp;gt; Outcomes &amp;gt; Edit outcome &amp;gt; Add new outcome &amp;gt; Select Scale or add new scale&lt;br /&gt; Use Existing outcome&lt;br /&gt; Add Outcome to course: Administration &amp;gt; Outcomes &amp;gt; Outcomes in course&lt;br /&gt; Add outcome from right column<br />
|}<br />
<br />
&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===&lt;br /&gt;[[Image:admin%20outcomes.png|admin outcomes.png]]===<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
===&lt;br /&gt; Use Outcomes in mahara assignment :===<br />
<br />
&lt;br /&gt; Turn editing on: Assignment &amp;gt; add mahara assignment &amp;gt; Select required Outcomes&lt;br /&gt; Assignment &amp;gt; mahara assignment &amp;gt; Select required Outcomes<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_4&quot;&gt;<br />
<br />
===[[Image:edit%20outcomes.png|edit outcomes.png]]===<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_5&quot;&gt;<br />
<br />
===Create A View:===<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:students.png|students.png]]<br />
| The Students creates a View in mahara that meets the &lt;br /&gt; requirements of the assessment. (Please see mahara manual)<br />
|<br />
[[Image:create%20view.png|create view.png]]<br />
|}<br />
<br />
&lt;br /&gt;<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_6&quot;&gt;<br />
<br />
===&lt;br /&gt;&lt;br /&gt; Submit Assignment:===<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:students.png|students.png]]<br />
| The Students then selects the mahara assignment (View) from within Moodle and submits it&lt;br /&gt; Select or Create View &amp;gt; Click Submit<br />
|}<br />
<br />
&lt;br /&gt;[[Image:submit%20assignment.png|submit assignment.png]]<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_7&quot;&gt;<br />
<br />
===&lt;br /&gt;&lt;br /&gt; Mark Activity:===<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:teacher.png|teacher.png]]<br />
| The Teacher then marks the assignment from within Moodle. &lt;br /&gt; Open submitted Activity &amp;gt; Select View Submitted Assignments &lt;br /&gt; Click on the link to the individual mahara Views&lt;br /&gt; Insert overall grade and grades against each outcomes and provide comments/feedback.<br />
|}<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_8&quot;&gt;<br />
<br />
===[[Image:moz-screenshot.png]][[Image:moz-screenshot-1.png]]&lt;br /&gt;[[Image:mark%20activity.png|mark activity.png]]&lt;br /&gt;&lt;br /&gt; Results copied to mahara:===<br />
<br />
{| width=&quot;100%&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
| Upon completion of the assessment process, the marks are copied from moodle back to mahara.<br />
|}<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_9&quot;&gt;<br />
<br />
===&lt;br /&gt; Check Results:===<br />
<br />
{| width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:students.png|students.png]]<br />
| The Students can then check their results in moodle or mahara&lt;br /&gt; Grades &amp;gt; Reports &amp;gt; User Report &amp;gt; Look at grades and feedback<br />
|}<br />
<br />
&lt;br /&gt; [[Image:check%20results.png|check results.png]]<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Admin.png]]<br />
*[[File:Admin_outcomes.png]]<br />
*[[File:Check_results.png]]<br />
*[[File:Create_view.png]]<br />
*[[File:Edit_outcomes.png]]<br />
*[[File:Enable_outcomes.png]]<br />
*[[File:Mark_activity.png]]<br />
*[[File:Moodle_logo.png]]<br />
*[[File:Students.png]]<br />
*[[File:Submit_assignment.png]]<br />
*[[File:Teacher.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/User_Guide_As_One_Page/Administrator_micro_manual&diff=1228User Guide/User Guide As One Page/Administrator micro manual2011-05-12T05:51:26Z<p>WikiSysop: </p>
<hr />
<div>[[Image:admin%20menu.jpeg|admin menu.jpeg]]<br />
<br />
{| width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;1&quot; cellpadding=&quot;20&quot;<br />
| height=&quot;20&quot; |<br />
| height=&quot;20&quot; valign=&quot;top&quot; |<br />
'''Admin home'''<br />
|-<br />
|<br />
<br />
|-<br />
|<br />
[[Image:config%20site.jpeg|config site.jpeg]]<br />
| height=&quot;20&quot; valign=&quot;top&quot; |<br />
From the Admin home menu item you can change the way your mahara site looks and behaves, as well as manage memberships to the site.<br />
|-<br />
|<br />
<br />
|}<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Configure site===<br />
<br />
[[Image:config%20site%20menu.png|config site menu.png]]<br />
<br />
{| width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;5&quot; cellpadding=&quot;1&quot;<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:site%20options.jpeg|site options.jpeg]]<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:edit%20site%20oaages.jpeg|edit site oaages.jpeg]]<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:links%20and%20resource.jpeg|links and resource.jpeg]]<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Site options'''<br />
| width=&quot;250&quot; valign=&quot;top&quot; | ''' Edit site page'''<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
'''Links and Resources Menu'''<br />
|-<br />
|<br />
<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This section lets you change site wide settings like naming your site, setting up virus checking, how long any specific session will last and whether there will be public views.<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This section allows you to edit the default text that appears on a number of pages within your mahara site.<br />
| width=&quot;250&quot; valign=&quot;top&quot; | Often you’ll want files and resources to be available to all your users. This section allows you to decide which files you want to appear on the front page of mahara. You can also decide which will appear to the general public and which will appear for logged in users.<br />
|}<br />
<br />
{| width=&quot;250&quot; border=&quot;1&quot; cellspacing=&quot;1&quot; cellpadding=&quot;1&quot;<br />
|<br />
[[Image:site%20files.jpeg|site files.jpeg]]<br />
|-<br />
| '''Site Files'''<br />
|-<br />
| This area provides you with a centralized spot to upload any files you want to associate with your mahara site. These can be used in links and resources on the mahara front page.<br />
|}<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Manage Users===<br />
<br />
[[Image:user%20search.jpeg|user search.jpeg]]<br />
<br />
{| width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;5&quot; cellpadding=&quot;1&quot;<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:user%20search%20dialog.jpeg|user search dialog.jpeg]]<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:suspended%20users.png|suspended users.png]]<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:admin%20users.png|admin users.png]]<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''User Search'''<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Suspended Users'''<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Site Staff / Site Admins /'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This feature allows you to locate users on your site. From the results you can change their account settings if required.<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This function allows you to see users who are suspended as well as allowing you to delete users completely.<br />
| width=&quot;250&quot; valign=&quot;top&quot; | Admin Notifications&lt;br /&gt; Site Staff and Site Admins allow you to add or remove administrators or staff to your institute. Notifications sets how the Admins get notifications sent from mahara.<br />
|}<br />
<br />
&lt;br /&gt;&lt;br /&gt;&lt;br /&gt;&lt;br /&gt;<br />
<br />
{| width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;5&quot; cellpadding=&quot;1&quot;<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:add%20user.png|add user.png]]<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:add%20users%20by%20CSV.png|add users by CSV.png]]<br />
| rowspan=&quot;4&quot; width=&quot;250&quot; valign=&quot;top&quot; |<br />
'''Notes'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Add User'''<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Add Users by CSV'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This area allows you to manually add users, set their roles and access, allocate how much storage space they get on the site, login as user and then let users know that their account is ready.<br />
| width=&quot;250&quot; valign=&quot;top&quot; | If you have a large number of users to add, mahara can import them from CSV files, created from spreadsheets.<br />
|}<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
===&lt;br /&gt;&lt;br /&gt;&lt;br /&gt;&lt;br /&gt; Administer Institutions===<br />
<br />
{| width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;5&quot; cellpadding=&quot;1&quot;<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:administer%20institutions.png|administer institutions.png]]<br />
| width=&quot;250&quot; valign=&quot;top&quot; |<br />
[[Image:plugin%20admin.png|plugin admin.png]]<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Manage Institutions'''<br />
| width=&quot;250&quot; valign=&quot;top&quot; | '''Plugin Administration'''<br />
|-<br />
| width=&quot;250&quot; valign=&quot;top&quot; | This mahara feature allows you to set up sub-sites to your main mahara site. You could set up a mahara site per school, or within your school district. Once you’ve set up a new institution you can then assign administrators, staff and users to it. The other tools in this section function exactly as they do at the mahara site level.<br />
| width=&quot;250&quot; valign=&quot;top&quot; | Here you’ll find a list of all the plugins that are installed to add functionality to your site. To select a plugin click on the config hyperlink.<br />
|}<br />
<br />
&lt;br /&gt;&lt;br /&gt;&lt;br /&gt;&lt;br /&gt;<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Add_user.png]]<br />
*[[File:Add_users_by_csv.png]]<br />
*[[File:Admin_menu.jpeg]]<br />
*[[File:Admin_users.png]]<br />
*[[File:Administer_institutions.png]]<br />
*[[File:Config_site.jpeg]]<br />
*[[File:Config_site_menu.png]]<br />
*[[File:Edit_site_oaages.jpeg]]<br />
*[[File:Links_and_resource.jpeg]]<br />
*[[File:Plugin_admin.png]]<br />
*[[File:Site_files.jpeg]]<br />
*[[File:Site_options.jpeg]]<br />
*[[File:Suspended_users.png]]<br />
*[[File:User_search.jpeg]]<br />
*[[File:User_search_dialog.jpeg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/User_Guide_As_One_Page&diff=1227User Guide/User Guide As One Page2011-05-12T05:51:20Z<p>WikiSysop: </p>
<hr />
<div>This document is an amalgamation of the pages in the [[User Guide|Mahara User Guide]]. It's here so that we can create PDFs of the user guide documentation from time to time, which you can download and print.<br />
<br />
'''Note:''' It's not a full representation of the pages yet, we are still adding pages to this document to be included. You could possibly edit this page and add more pages to it to help out ;)<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
==Introduction==<br />
<br />
&lt;div class=&quot;content&quot;&gt;&lt;div class=&quot;wiki-content&quot;&gt;<br />
<br />
Welcome to the '''Mahara User Guide'''! This user guide is designed to provide documentation for people who will use Mahara on a day-to-day basis. '''This document is designed to be read by any user of Mahara''', as most users will have access to the features documented here. Site and Institution Administrators (will eventually) have separate user guides.<br />
<br />
Without any further ado, let's begin!<br />
<br />
====What is Mahara?====<br />
<br />
If you're wondering what Mahara or an e-portfolio is, why you might want one and what it can do for you, then read on - you're about to find out.<br />
<br />
At the simplest level, Mahara is two things: an [http://en.wikipedia.org/wiki/Eportfolio e-portfolio] and a [http://en.wikipedia.org/wiki/Social_network social networking] system combined. An e-portfolio is a system in which students can record &quot;evidences of lifelong learning&quot; - such as essays, artwork or other such things they produce that can be stored digitally. Such things are known as '''artefacts''' in Mahara. Social networking systems need little introduction - think [http://www.myspace.com/ Myspace], [http://facebook.com/ Facebook] or [http://bebo.com/ Bebo]. Basically, they give a way for people to interact with their friends and create their own online communities.<br />
<br />
But Mahara is much more than just a place to store files. Mahara also includes blogging, a resumé builder, [http://moodle.org/ Moodle] integration and the standout views framework.<br />
<br />
====What are Views?====<br />
<br />
Views give students a way to display their artefacts in a way they choose, to the people they want to see them. For instance, a student could have one view that contains a journal of their progress and some notes for a project they are currently doing, visible only to their teachers. Also, they could have another view, showing photos from their holiday in Scotland, that their friends can see.<br />
<br />
This framework gives users tremendous flexibility in how their data is shown to others. Furthermore, they are not restricted to just placing artefacts in their views - Mahara allows users to insert Youtube videos, Flickr photos, RSS feeds and much more. And the entire framework is pluggable - so anything you imagine could become part of a view, simply by writing a new plugin.<br />
<br />
====The Mahara framework====<br />
<br />
&lt;font face=&quot;Verdana&quot;&gt;With Mahara, '''you '''control which items and what information within your portfolio other users see. Such items and information are termed artefacts. To facilitate this access control, all artefacts you wish to show to other users need to be arranged into one area. In Mahara this compilation of selected artefacts is called a View. You can have as many Views as you like, each with a different collection of artefacts, and intended purpose and audience. Your audience, or the people you wish to give access to your View, can be added as individuals or as a member of a Group. It can even be made publicly available.&lt;/font&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana&quot;&gt;For example you could create a View for your friend and family that includes holiday photos and a personal Blog. You could create another View for your tutor, which includes assessments and your reflective learning journal. You could create a third View to showcase your best pieces of work and your resumé for potential employers. In fact you can create as many Views as you wish for work, study and leisure purposes.&lt;/font&gt;<br />
<br />
The diagram below of example artefacts, Views and groups illustrates how content in Mahara can be shared and reused in different contexts and for different audiences.<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt;&lt;font size=&quot;11pt&quot;&gt;[[Image:Mahara%20structure.png|Mahara structure.png]]&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;<br />
<br />
====How does Mahara fit in to the e-learning landscape?====<br />
<br />
If you think of [http://en.wikipedia.org/wiki/Learning_Management_System LMS]es such as Moodle, Sakai and Blackboard as the formal, structured side of e-learning, then Mahara is the social, reflective side. An LMS and an e-portfolio complement one another in an online learning environment.<br />
<br />
In particular, while Mahara's APIs are open to all, Mahara can integrate with Moodle to provide a streamlined user experience. Currently this is limited to [http://en.wikipedia.org/wiki/Single_sign-on SSO], but from Moodle 2.0, students will be able to export assignments, blogs and much more straight into Mahara to use as artefacts (which can then, of course, be placed into views).<br />
<br />
====What if Mahara does not support a feature I want?====<br />
<br />
Mahara has been designed from the ground up to be an open, pluggable system. Creating new artefacts, authenticating against a custom system and much more can be implemented simply through writing a plugin that uses the appropriate core API. What this means is that it is free and easy for you to customise almost anything about Mahara to suit your needs - and [http://www.mahara.org/partners paid support is available] from the creators of Mahara should you require.<br />
<br />
====Other things to do====<br />
<br />
Now you have a basic idea of what Mahara is, you could:<br />
<br />
* Read the [http://www.mahara.org/features list of features] that Mahara comes with<br />
* [http://demo.mahara.org/ Explore the demo] or [[Download Mahara|download mahara]] for yourself to play with<br />
* [http://mahara.org/registration.php Sign up to the mahara.org community] and being asking questions and contributing in the [http://mahara.org/forums forums] <br />
* Continue reading this user guide!<br />
<br />
&lt;/div&gt;&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Contextual Help===<br />
<br />
You will find contextual help throughout Mahara, wherever you see the question mark symbol [[Image:icon_help.png|icon_help.png]]. Click on this to open a dialogue box containing help on the area you are currently working in. Contextual help is designed to help guide you through Mahara so please use this feature as much as you require.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
===Definitions===<br />
<br />
Some useful definitions in the context of using Mahara:<br />
<br />
'''ePortfolio''' - An electronic portfolio is an online collection of reflections and digital artefacts that students and staff can use to demonstrate their development over time to various audiences. [http://en.wikipedia.org/wiki/Eportfolio Wikipedia has a page] on ePortfolios.<br />
<br />
'''Artefacts '''– Artefacts are items and information that ePortfolio users can create both within and outside of their portfolio. Within Mahara Artefacts include images, documents, blogs, personal information and resumé information.<br />
<br />
'''View''' – A &quot;web page&quot; that gives users the chance to show off artefacts in their portfolio to others.<br />
<br />
'''Groups '''– Collections of users, gathered around a common purpose or task. Users can collaborate on creating group Views, and build their community through Group Forums.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_4&quot;&gt;<br />
<br />
===Logging In===<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;Your login details will be the username and password you entered during registration or as assigned by your institution or Site Administrator. Where relevant, you will also need to select the institution with which you are associated. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
'''&lt;font size=&quot;12pt&quot;&gt;Your username may include alphanumeric characters, full stops and @ symbols. Your username must be between 3 and 30 characters long&lt;/font&gt;'''&lt;font size=&quot;12pt&quot;&gt;. Usernames are &lt;span&gt;not case sensitive&lt;/span&gt;. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;Your password must be at least six characters long and contain at least one digit and two letters. Your password may not be the same as your username and is &lt;span&gt;case sensitive&lt;/span&gt;. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;Once you have submitted the registration form, an email will immediately be sent to your email address. This email will contain a link which once followed, will confirm your account and log you into the system. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;font face=&quot;Verdana&quot;&gt;If you do not receive an email confirmation message after registration, please ensure the registration message has not been caught by your email junk filter. Please contact the Site &lt;/font&gt;&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;&lt;font size=&quot;12pt&quot;&gt;Administrator if you have any problems registering. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;[[Image:login%20box.jpg|login box.jpg]]&lt;/font&gt;<br />
<br />
&lt;/div&gt;&lt;/div&gt;&lt;div id=&quot;section_5&quot;&gt;<br />
<br />
==My Portfolio==<br />
<br />
[[Image:my%20portfolio%20menu%20bar.png|my portfolio menu bar.png]]<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;It might be useful to consider the My Portfolio section of Mahara as your main personal repository of resources and information. In here, you can begin to add content to your ePortfolio, in the shape of uploaded resources, or Artefacts, Blogs within Mahara and store them in '''My Files''' and '''My Blogs'''. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When you decide to start sharing selected Artefacts, you can use '''My Views''' to begin packaging them up for presentation. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;div id=&quot;section_6&quot;&gt;<br />
<br />
===My Blogs===<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;A web log or Blog is a journal-like tool that allows you to record your thoughts and experiences. By adding your Blog to a View you can allow others users to place feedback and comments, allowing you to create a dialogue with your audience. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Creating a Blog within Mahara is a '''two stage process'''. First a Blog must be created and given a title and description. Then, you can add Blog posts to your Blog. Think of the first stage as rather like creating a wrapper or container in which you can begin to add your creative writing, reflective thoughts and comments through Blog posts. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;div id=&quot;section_7&quot;&gt;<br />
<br />
====Add A Blog Post====<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Click on Blog title and select Add Post. If it is a new Blog there will also be a message that says ‘No posts yet. Add one’. &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:add%20blog%20post.png|add blog post.png]]<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Give your Blog post a title and in the HTML text editor, add your thoughts! &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;center&gt;&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;&lt;/center&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You can add Tags to Blogs and Blog posts you create within Mahara. Tags allow you to add descriptive labels to Blogs and create an index of tag classifications. Add words or phrases separated by commas. So for this example, the following tags have been added:&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;eLearning, Staff development, pedagogy &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font color=&quot;red&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tip&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;span&gt; &lt;/span&gt;- When you add subsequent Blog posts, you can click on '''Show my tags''' to view a list of all tags you have previously used. This can save time if you need to frequently upload Artefacts with the same tags. Simply click on any relevant existing tags, and they will be added to your new Artefact. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Over time your tags list will develop into a comprehensive list of keywords for your Artefacts and will aid the search process. &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:new%20blog%20post.png|new blog post.png]]<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Save as draft &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If you would like to come back to your Blog posting at a later time to add or modify it, you can hold off from publishing it by saving it as a Draft by ticking the 'This post is a draft' checkbox. When your post is a draft, no one except you can see it. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:save%20as%20a%20draft.png|save as a draft.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Save post &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When you have completed your posting and you are happy with it, select Save Post.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If the Blog post has been marked as Draft, it will appear as Draft and can be published later. &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:marked%20as%20draft.png|marked as draft.png]]<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If the Blog post has not been marked as draft, it will appear as Published. In both cases the full Blog post will be displayed, along with its title and date and time of which it was posted. The parent title of the Blog to which it belongs is indicated in bolder type at the top of the screen.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:marked%20as%20published.png|marked as published.png]]<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Note:&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; Saving and publishing your post means that it is saved and stored in the My Blogs area. &lt;span&gt; &lt;/span&gt;It does not mean that other users can yet read it. Until you decide to make it available by adding it to a View and assigning access rights, nobody else will be able to see or comment on it. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Whilst a Blog itself is considered an Artefact, so are any individual Blog postings you create. This means that both Blogs and individual Blog posts can be added to a View.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; Remember that until you add it to a View, your Blog remains visible only to you. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_8&quot;&gt;<br />
<br />
====Add a file from My Files====<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If you have already uploaded files to the My Files area, you can quickly associate them with a Blog post. Select Browse my files to display a list of the files uploaded to your file store. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:browse%20my%20files.png|browse my files.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Chose a relevant file, such as an image or photograph and click Attach. This will automatically add your file to the Blog and will be displayed as an attached file.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:browse%20attached%20files.png|browse attached files.png]] &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_9&quot;&gt;<br />
<br />
====Blog comments====<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When reading another person’s Blog, via a View, you may be able to submit comments on their posts. To comment on another user’s Blog, open the applicable View, click on the Blog’s name or title and select the Place Feedback option at the bottom of the screen. Currently this will only work if a user has chosen to display Recent Blog Posts in their View. This displays a list up to a maximum of 10 most recent posts, by title. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Other users with access rights to the View can click on a title and submit Public or Private Blog Comments (Feedback). Public Feedback may be seen by other users who have access to the View. Private Feedback is only visible to the View owner. A View owner may choose to make your public feedback private, but not vice versa. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font color=&quot;red&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tip:&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; To edit your Blog description, view the Blog list in My Blogs, click on the title and select Settings. You can now amend the title or description of your Blog. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;V1.3&lt;/font&gt;&lt;/span&gt;'''<br />
<br />
* Prevent comments on blog posts &lt;br /&gt; There is now an Allow comments field that can be set for each blog post &lt;br /&gt;'''MyPortfolio &amp;gt; My Blogs &amp;gt; New Post &amp;gt; Allow comments'''&lt;br /&gt; By default this is turned on – if you don’t want others to make comments on your posting then untick this box.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_10&quot;&gt;<br />
<br />
====Embed an image to a Blog post====<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Once you attach an image to a Blog post, you can then embed it into the body of the post. Before you do anything else, position your cursor at the place in your Blog post where you would like the image to appear. Click on the image icon in the HTML editor (this is the one that looks like a green tree) From the Insert Image box select the appropriate file from the drop down box and click Insert. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:embed%20an%20image.png|embed an image.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You can also embed an image as a link from another website. You can either type in the url of the image or drag and drop the image from the website into the HTML editor. Please ensure you have appropriate copyright permissions to use the image. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;For best results images should be no more than 400 x 400 pixels and have less than 5 pixels of padding on each side. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_11&quot;&gt;<br />
<br />
====Upload a file to a Blog====<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You may upload or attach files to a Blog posting. Files added to a Blog posting are automatically stored within your file repository area in a folder called ‘Blogfiles’ and contribute to your file storage quota. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When attempting to upload a file you will always see the following copyright notice. &lt;/font&gt;&lt;/span&gt;&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:copyright%20notice.png|copyright notice.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;In order to progress, you must comply and agree to the Copyright notice by ticking the copyright box.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Browse your desktop in the usual way to find a file or image to upload. When attempting to upload a file you will see the following fields: &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Name&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; - You can add a title when uploading a file, otherwise it will default to the existing file name. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Description &lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;– You may choose to give your file a description &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tags&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – You can add tags to Artefacts and Views you create within Mahara. Tags allow you to add descriptive labels to Artefacts and Views and create an index of tag classifications. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Once you have filled in the required fields, click Upload to complete the add file process. You will see a confirmation message and details of the attached file. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:attached%20files.png|attached files.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_12&quot;&gt;<br />
<br />
====View Blog====<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;To View your Blogs and Blog posts, go to My Blogs, for a list of Blogs. Click on a Blog title for a list of Blog posts associated with that Blog.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The two stage process of creating a blog and then adding Blog posts will result in a Blog which is still only visible to you, the owner. To enable others to read your Blogs requires a further step - add part or all of it to a View &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt;&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/User_Guide_As_One_Page/Administrator_micro_manual|Administrator micro manual]]<br />
* [[User_Guide/User_Guide_As_One_Page/Mahara//Moodle_outcomes_micro_manual|Mahara/Moodle outcomes micro manual]]<br />
* [[User_Guide/User_Guide_As_One_Page/User_cheat_sheet|User micro manual]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/Tutorials_about_Mahara&diff=1226User Guide/Tutorials about Mahara2011-05-12T05:51:15Z<p>WikiSysop: </p>
<hr />
<div>On this page we collect user-generated content to enrich the User Guide. Mahara users create their own guides or training material to adapt it to their own needs. If you want to share your material, you can post a link here.<br />
<br />
Please provide as much information as possible in the table below.&lt;strike&gt;&lt;br /&gt;&lt;/strike&gt;<br />
<br />
{| summary=&quot;Mahara users link to their own tutorials, workshop material etc.&quot; width=&quot;100%&quot; border=&quot;1&quot; cellspacing=&quot;5&quot; cellpadding=&quot;5&quot; align=&quot;left&quot;<br />
| '''Title '''(linked to the material)<br />
| '''Author(s) / Contact&lt;br /&gt;'''<br />
| '''Provider'''<br />
| '''Target audience'''<br />
| '''Mahara version'''<br />
| '''Language(s)'''<br />
| '''File format(s)'''<br />
| '''License'''<br />
| '''Comments'''<br />
|-<br />
|<br />
[http://new-learning.newham.ac.uk/file.php/1/Mahara%20Video%20Tutorial%20Dec%2010/Mahara%20Video%20Tutorials%20Dec%2011.html Mahara Video Tutorials]<br />
| Niraj Bhatt<br />
|<br />
[http://new-learning.newham.ac.uk/ NewLearning] ([http://www.newham.ac.uk/ Newham College of Further Education], UK)<br />
| tertiary students; instructors<br />
| 1.2<br />
| English<br />
| Camtasia Studio videos embedded in HTML<br />
|<br />
| Step-by-step guide taking students through the process of creating a portfolio in Mahara.<br />
|-<br />
|<br />
[http://blog.bsce.uni.lu/support/mahara-quick-start-guide/ Mahara Quick Start Guide]<br />
|<br />
[http://virtualbreath.net/curious/ Kristina D.C. Hoeppner]<br />
|<br />
[http://bsce.uni.lu/ BScE] ([http://www.uni.lu/ University of Luxembourg], LU)<br />
| BA students; instructors<br />
| 1.2<br />
| English, some German<br />
| HTML, some videos on YouTube<br />
|<br />
[http://creativecommons.org/licenses/by-nc-sa/3.0/ CC BY-NC-SA]<br />
| Step-by-step guide on how students can get started to create and upload content to Mahara. Except for a few references to the BScE (especially logging in via Moodle), the guide is pretty generic.<br />
|-<br />
|<br />
[https://eportfolio.pace.edu/view/_custom/helpmain.html#q12 Mahara: Getting Started]<br />
| Beth Klingner<br />
|<br />
[http://web.pace.edu/page.cfm?doc_id=17874 CTLT] ([http://www.pace.edu/ Pace University], USA)<br />
| tertiary students<br />
| 1.2<br />
| English<br />
| HTML<br />
|<br />
| Step-by-step guide<br />
|-<br />
|<br />
[http://www.usq.edu.au/users/evansp/browse/Mahara/toc.htm ePortfolios at USQ ]<br />
|<br />
[http://www.usq.edu.au/users/evansp/ Peter Evans ]<br />
|<br />
[http://www.usq.edu.au/ University of Southern Queensland], AU<br />
| tertiary students<br />
| 1.2<br />
| English<br />
| HTML<br />
|<br />
| extensive guide, also links to other guides<br />
|-<br />
|<br />
[http://www.plymouth.edu/help/mahara/tutorials/final.html Mahara Tutorial Theater] and [http://www.plymouth.edu/help/mahara/mahara.html Mahara Help Documentation]<br />
|<br />
|<br />
[http://www.plymouth.edu/online/ Learning Technologies and Online Education] ([http://www.plymouth.edu/ Plymouth State University], USA)<br />
| tertiary students<br />
| 1.2<br />
| English<br />
| Camtasia Studio videos embedded in HTML<br />
|<br />
| students can keep their portfolio after graduation<br />
|-<br />
|<br />
[http://moodle.njit.edu/moodle/tutorials/faculty/mahara_guide.pdf Using Mahara]<br />
|<br />
|<br />
[http://www.njit.edu/ New Jersey Institute ofTechnology] , USA<br />
| tertiary students<br />
| 1.2<br />
| English<br />
| PDF<br />
|<br />
|<br />
brief guide listed under [http://moodle.njit.edu/tutorials/faculty/ instructor tutorials]<br />
|-<br />
|<br />
[http://uc-dev.maharasites.com/view/view.php?id=973 Technical Support for Mahara]<br />
| Rosalie Domaschenz<br />
|<br />
[http://leadingcurriculum.blogspot.com/p/secondary-teaching-studies.html Secondary Teaching], [http://www.canberra.edu.au/home/ University of Canberra], Canberra, AU<br />
| tertiary students<br />
| 1.2<br />
| English<br />
| videos<br />
|<br />
| tech support in a Mahara view<br />
|-<br />
|<br />
[http://www.markdrechsler.com/?p=144 Mahara assessment in Moodle]<br />
|<br />
[http://www.markdrechsler.com/ Mark Drechsler]<br />
| Mark Drechsler<br />
| tertiary/sceondary students<br />
| 1.2<br />
| English<br />
| Flash video<br />
|<br />
| Demo of integrating moodle outcomes with mahara<br />
|-<br />
|<br />
[http://screenr.com/user/donpresant Short screencasts on using Mahara]<br />
|<br />
[http://twitter.com/donpresant Don Presant]<br />
| Don Presant<br />
|<br />
| 1.3<br />
| English<br />
| screenr screencast<br />
|<br />
|<br />
Demonstrations of various Mahara functionalities using the [http://careerportfolio.mb.ca/ Career Portfolio Manitoba]<br />
|-<br />
|<br />
[http://edulearning.at/maharatutorial/index.html Mahara Tutorial]<br />
| Franz Ehrnleitner<br />
|<br />
[http://www.ph-ooe.at/ Pädagogische Hochschule Oberösterreich], A<br />
|<br />
| 1.3<br />
| German<br />
| online tutorial<br />
|<br />
[http://creativecommons.org/licenses/by-nc-sa/3.0/at/ CC-BY-NC-SA Austria]<br />
| tutorial for educational institutions in German with text and screenshots<br />
|-<br />
|<br />
[http://acc.aub.edu.lb/mod/book/view.php?id=682&amp;chapterid=1061 Mahara tutorial]<br />
| Academic Computing Center<br />
|<br />
[http://acc.aub.edu.lb/ American University of Beirut], LB<br />
| tertiary<br />
| 1.3<br />
| English<br />
| online tutorial<br />
| All rights reserved<br />
|<br />
|-<br />
|<br />
[http://eportfoliosineducation.info/#/mahara-help/4532527452 Mahara Help]<br />
| Faculty of Education<br />
|<br />
[http://www.gla.ac.uk/ University of Glasgow], UK<br />
| tertiary<br />
| 1.3<br />
| English<br />
| online tutorial, printable<br />
|<br />
| created for the University of Glasgow installation of Mahara; there is a long guide and &quot;Mahara Minis&quot;<br />
|-<br />
|<br />
[http://portfolio.gla.ac.uk/artefact/file/download.php?file=59205&amp;view=8661&amp;view=8574&amp;view=7587 Handy tips from the Hunterian]<br />
| Sally-Anne Coupar<br />
|<br />
Hunterian Museum, [http://www.gla.ac.uk/ University of Glasgow], UK<br />
| tertiary<br />
|<br />
| English<br />
| PDF<br />
|<br />
|<br />
|}</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/4_Settings/Institution_Membership&diff=1225User Guide/4 Settings/Institution Membership2011-05-12T05:51:12Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If you are a member of any institutions, they will be listed here. You may also request membership of an institution, and if any institutions have invited you to join, you can accept or decline the invitation. To requst membership of an institution, select the name from the drop down menu and click Send request.&lt;br /&gt;&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:institution%20membership.jpg|institution membership.jpg]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Institution_membership.jpg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/4_Settings/Activity_Preferences&diff=1224User Guide/4 Settings/Activity Preferences2011-05-12T05:51:08Z<p>WikiSysop: </p>
<hr />
<div>&lt;font size=&quot;12pt&quot;&gt;Set your activity preferences to determine how you receive notifications for each activity type within Mahara. You can select from an Activity Log in your Notifications area, an email to your primary email address each time an activity occurs, or an email digest of the last 24 hours activity to your primary email address. &lt;/font&gt;<br />
<br />
[[Image:Activity%20preferences.jpg|Activity preferences.jpg]]<br />
<br />
===Files===<br />
<br />
*[[File:Activity_preferences.jpg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/4_Settings/1_Preferences&diff=1223User Guide/4 Settings/1 Preferences2011-05-12T05:51:01Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Use to change your password. Please note, your password must total at least six characters. It must contain at least one number, and at least two letters. Passwords are case sensitive, and must be different from your username. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:preferences.jpg|preferences.jpg]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Preferences.jpg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/4_Settings&diff=1222User Guide/4 Settings2011-05-12T05:50:57Z<p>WikiSysop: </p>
<hr />
<div>[[Image:settings2%20toolbar.jpg|settings2 toolbar.jpg]]<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Before you progress too far into Mahara, you may wish to explore the Settings features. The Settings tab enables you to configure and determine how you will use the site, how friends may link with you and how the system will contact you with important information and notifications. If applicable you can also use this to oversee your Institution membership(s) &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;There are four sub menus in the settings menu; '''Preferences, Notifications, Activity Preferences '''and''' Institutional Membership '''&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;'''V1.3'''&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The Settings menu has been taken off the main menu and appears as a link in the upper right hand corner. Preferences have been renamed to My Account and Activity preferences have been combined into the Notifications menu.&lt;br /&gt;&lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Settings_toolbar.jpg]]<br />
*[[File:Settings2_toolbar.jpg]]<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/4_Settings/1_Preferences|Preferences]]<br />
* [[User_Guide/4_Settings/2_Notifications|Notifications]]<br />
* [[User_Guide/4_Settings/Activity_Preferences|Activity Preferences]]<br />
* [[User_Guide/4_Settings/Institution_Membership|Institution Membership]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/3_My_Groups/Viewing_group_details&diff=1221User Guide/3 My Groups/Viewing group details2011-05-12T05:50:53Z<p>WikiSysop: </p>
<hr />
<div>All of the goups that you belong to or have requested membership of are listed w&lt;font face=&quot;Verdana, sans-serif&quot;&gt;ith the group name and the group members.&lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;The person whio created the group underneath the group name and a brief description of the group is underneath this.&lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;[[Image:my%20groups.png|my groups.png]]&lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;To see the group details click on the group links - &lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;This will show any group activity , views that have been made available to the group and forums that have been created for the group.&lt;/font&gt;<br />
<br />
&lt;br /&gt; [[Image:groups%20interface.png|groups interface.png]]<br />
<br />
&lt;font color=&quot;rgb(255, 0, 0)&quot;&gt;New&lt;/font&gt; Views – it is possible to have a view that belongs to a group rather than an individual.<br />
<br />
The group view can be editted by anyone in the group the same as an individual view<br />
<br />
&lt;br /&gt; Files – Files can be accessed and uploaded by any member of the group the same way as an individual can edit the files.<br />
<br />
===Files===<br />
<br />
*[[File:Groups_interface.png]]<br />
*[[File:My_groups.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/3_My_Groups/Group_Forums/Selecting_actions_for_forum_topics&diff=1220User Guide/3 My Groups/Group Forums/Selecting actions for forum topics2011-05-12T05:50:49Z<p>WikiSysop: </p>
<hr />
<div>&lt;font face=&quot;Verdana, sans-serif&quot;&gt;Select the topics you want to perform actions on&lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;The following actions are available&lt;/font&gt;<br />
<br />
* &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Subscribe/unsubscribe – receive emails if post to this topic is made – it is also possible to subscribe to all of the topics by selecting subscribe to &lt;/font&gt;&lt;font face=&quot;Verdana, sans-serif&quot;&gt;forum button&lt;/font&gt;<br />
* &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Sticky/Unsticky – this topic gores to the top of the topic list&lt;/font&gt;<br />
* &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Open/Close – closed topic mean that no one can post messages to the topic&lt;/font&gt;<br />
<br />
[[Image:forum%20actions.png|forum actions.png]]<br />
<br />
===Files===<br />
<br />
*[[File:Forum_actions.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/3_My_Groups/Group_Forums/Create_New_Topic&diff=1219User Guide/3 My Groups/Group Forums/Create New Topic2011-05-12T05:50:39Z<p>WikiSysop: </p>
<hr />
<div>&lt;font face=&quot;Verdana, sans-serif&quot;&gt;Creating topics allow discussions to be organised &lt;/font&gt;<br />
<br />
* &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Select the forum for the new topic &lt;/font&gt;<br />
* &lt;font face=&quot;Verdana, sans-serif&quot;&gt;select New Topic&lt;/font&gt;<br />
* &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Fill in the Topic subject and body&lt;/font&gt;<br />
* &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Select the options of sticky (top of every page) or closed topics (replied by moderators or owners)if you need to &lt;/font&gt;&lt;br /&gt; <br />
<br />
&lt;br /&gt;<br />
<br />
[[Image:forum%20add%20topics.png|forum add topics.png]]<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;This will appear on the forum page&lt;/font&gt;<br />
<br />
&lt;br /&gt;<br />
<br />
[[Image:forum%20page.png|forum page.png]]<br />
<br />
&lt;br /&gt;<br />
<br />
&lt;br /&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Forum_add_topics.png]]<br />
*[[File:Forum_page.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/3_My_Groups/Group_Forums/Create_forum&diff=1218User Guide/3 My Groups/Group Forums/Create forum2011-05-12T05:50:35Z<p>WikiSysop: </p>
<hr />
<div>&lt;font face=&quot;Verdana, sans-serif&quot;&gt;In Groups, Group Administrators can add Forums. These can then be used to start and respond to discussion topics, or simply to send out news. Forums are configurable with respect to email notification, moderation, and permission to initiate discussions.&lt;br /&gt;&lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;To add a Forum:&lt;/font&gt;<br />
<br />
# &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Select My Groups&lt;br /&gt;&lt;/font&gt;<br />
# &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Click on the Group to which you want to add the Forum&lt;/font&gt;<br />
# &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Click on the Forums link in the menu, &lt;/font&gt;&lt;font face=&quot;Verdana, sans-serif&quot;&gt;to display the existing Forums for that Group&lt;br /&gt;&lt;/font&gt;<br />
# &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Select the New Forum&lt;/font&gt;&lt;font face=&quot;Verdana, sans-serif&quot;&gt; link&lt;br /&gt;&lt;/font&gt;<br />
# &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Add a Title and description for the forum&lt;/font&gt;&lt;font face=&quot;Verdana, sans-serif&quot;&gt;&lt;br /&gt;&lt;/font&gt;<br />
# &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Select Settings (n.b. Settings for the Forum, not your account Settings)&lt;/font&gt;&lt;br /&gt;<br />
#* Set the '''Subscription''' i.e. decide whether you want Group members to receive contributions to the Forum by email as a default, rather than having to log in to Mahara to check)<br />
#* Set the '''Order '''i.e. decide where you want the link to this Forum to appear in relation to any other Forums in the Group<br />
#* If appropriate, choose '''Moderators '''from within the Group. Moderators can edit posts from other Group members.<br />
#* Decide '''who can initiate discussions''' in the Forum i.e. everybody or only Moderators and Admins?<br />
# &lt;font face=&quot;Verdana, sans-serif&quot;&gt;Finally, click Save&lt;/font&gt;<br />
# The Forum now exists; the next thing to do is to encourage Group members to participate in it.<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;[[Image:Add%20forum.png|Add forum.png]]&lt;/font&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Add_forum.png]]<br />
*[[File:Forum.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/Z_Export&diff=1217User Guide/2 My Portfolio/Z Export2011-05-12T05:50:04Z<p>WikiSysop: </p>
<hr />
<div>This option lets users save their eportfolio so they can use it at another place of learning and helps support life long learning.<br />
<br />
&lt;br /&gt; Select '''My Portfolio''' '''&amp;gt; Export'''<br />
<br />
'''[[Image:export.png|export.png]]'''<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===&lt;br /&gt; Export formats===<br />
<br />
&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
====&lt;br /&gt; Standalone HTML Website====<br />
<br />
&lt;br /&gt; Select this if you are not going to be using mahara or a LEAP2A eportfolio system in the future or the site that has your portfolio.&lt;br /&gt; Select '''Generate Export'''&lt;br /&gt; A zip file will be generated called '''mahara-export-html-user#######.zip'''<br />
<br />
&lt;br /&gt; This file will contain all of the folders and files from your view with navigation to pages also created.<br />
<br />
&lt;br /&gt; To view your eportfolio files in your web browser – unzip the mahara export file (usually done by double clicking the file) and open the '''index.html''' file.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
====&lt;br /&gt; LEAP2A====<br />
<br />
&lt;br /&gt; This is a standard specification for eportfolios that was developed with other eportfolio systems to enable information to be shared between eportfolio systems. Its purpose is to represent information that an individual creates or controls, the specification is stable and is also able to be extended.<br />
<br />
&lt;br /&gt; Choose LEAP2a if you want to export this to another eportfolio system that supports this. Click on '''other LEAP2A compliant '''systems link to see the other eportfolio systems that support this standard.<br />
<br />
&lt;br /&gt; Select '''Just some of my Views''' if you don’t want to export all your views<br />
<br />
[[Image:export%20selection.png|export selection.png]]&lt;br /&gt; There is a preview of the view in case you are not sure what the view looks like.<br />
<br />
&lt;/div&gt;&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Export.png]]<br />
*[[File:Export_selection.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/My_Blogs/Upload_a_file_to_a_Blog&diff=1216User Guide/2 My Portfolio/My Blogs/Upload a file to a Blog2011-05-12T05:49:56Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You may upload or attach files to a Blog posting. Files added to a Blog posting are automatically stored within your file repository area in a folder called ‘Blogfiles’ and contribute to your file storage quota. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When attempting to upload a file you will always see the following copyright notice. &lt;/font&gt;&lt;/span&gt;&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:copyright%20notice.png|copyright notice.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;In order to progress, you must comply and agree to the Copyright notice by ticking the copyright box.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Browse your desktop in the usual way to find a file or image to upload. When attempting to upload a file you will see the following fields: &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Name&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; - You can add a title when uploading a file, otherwise it will default to the existing file name. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Description &lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;– You may choose to give your file a description &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tags&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – You can add tags to Artefacts and Views you create within Mahara. Tags allow you to add descriptive labels to Artefacts and Views and create an index of tag classifications. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Once you have filled in the required fields, click Upload to complete the add file process. You will see a confirmation message and details of the attached file. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:attached%20files.png|attached files.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Attached_files.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/My_Blogs/Embed_an_image_to_a_Blog_post&diff=1215User Guide/2 My Portfolio/My Blogs/Embed an image to a Blog post2011-05-12T05:49:52Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Once you attach an image to a Blog post, you can then embed it into the body of the post. Before you do anything else, position your cursor at the place in your Blog post where you would like the image to appear. Click on the image icon in the HTML editor (this is the one that looks like a green tree) From the Insert Image box select the appropriate file from the drop down box and click Insert. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:embed%20an%20image.png|embed an image.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You can also embed an image as a link from another website. You can either type in the url of the image or drag and drop the image from the website into the HTML editor. Please ensure you have appropriate copyright permissions to use the image. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;For best results images should be no more than 400 x 400 pixels and have less than 5 pixels of padding on each side. &lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Embed_an_image.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/My_Blogs/Create_a_Blog&diff=1214User Guide/2 My Portfolio/My Blogs/Create a Blog2011-05-12T05:49:48Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Use Add Blog to create a new Blog. Give it a suitable title and description. Select Create Blog. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:new%20blog.png|new blog.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The Blog title will appear in an alphabetical list under My Blogs, along with any other Blogs you have already created.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:my%20blogs.png|my blogs.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:My_blogs.png]]<br />
*[[File:New_blog.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/My_Blogs/Add_a_file_from_My_Files&diff=1213User Guide/2 My Portfolio/My Blogs/Add a file from My Files2011-05-12T05:49:41Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If you have already uploaded files to the My Files area, you can quickly associate them with a Blog post. Select Browse my files to display a list of the files uploaded to your file store. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:browse%20my%20files.png|browse my files.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Chose a relevant file, such as an image or photograph and click Attach. This will automatically add your file to the Blog and will be displayed as an attached file.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:browse%20attached%20files.png|browse attached files.png]] &lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Browse_attached_files.png]]<br />
*[[File:Browse_my_files.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/My_Blogs/Add_a_Blog_Post&diff=1212User Guide/2 My Portfolio/My Blogs/Add a Blog Post2011-05-12T05:49:37Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Click on Blog title and select Add Post. If it is a new Blog there will also be a message that says ‘No posts yet. Add one’. &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:add%20blog%20post.png|add blog post.png]]<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Give your Blog post a title and in the HTML text editor, add your thoughts! &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;center&gt;&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;&lt;/center&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You can add Tags to Blogs and Blog posts you create within Mahara. Tags allow you to add descriptive labels to Blogs and create an index of tag classifications. Add words or phrases separated by commas. So for this example, the following tags have been added:&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;eLearning, Staff development, pedagogy &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font color=&quot;red&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tip&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;span&gt; &lt;/span&gt;- When you add subsequent Blog posts, you can click on '''Show my tags''' to view a list of all tags you have previously used. This can save time if you need to frequently upload Artefacts with the same tags. Simply click on any relevant existing tags, and they will be added to your new Artefact. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Over time your tags list will develop into a comprehensive list of keywords for your Artefacts and will aid the search process. &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:new%20blog%20post.png|new blog post.png]]<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Save as draft &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If you would like to come back to your Blog posting at a later time to add or modify it, you can hold off from publishing it by saving it as a Draft by ticking the 'This post is a draft' checkbox. When your post is a draft, no one except you can see it. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:save%20as%20a%20draft.png|save as a draft.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Save post &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When you have completed your posting and you are happy with it, select Save Post.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If the Blog post has been marked as Draft, it will appear as Draft and can be published later. &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:marked%20as%20draft.png|marked as draft.png]]<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If the Blog post has not been marked as draft, it will appear as Published. In both cases the full Blog post will be displayed, along with its title and date and time of which it was posted. The parent title of the Blog to which it belongs is indicated in bolder type at the top of the screen.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:marked%20as%20published.png|marked as published.png]]<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Note:&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; Saving and publishing your post means that it is saved and stored in the My Blogs area. &lt;span&gt; &lt;/span&gt;It does not mean that other users can yet read it. Until you decide to make it available by adding it to a View and assigning access rights, nobody else will be able to see or comment on it. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Whilst a Blog itself is considered an Artefact, so are any individual Blog postings you create. This means that both Blogs and individual Blog posts can be added to a View.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; Remember that until you add it to a View, your Blog remains visible only to you. &lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Add_blog_post.png]]<br />
*[[File:Marked_as_draft.png]]<br />
*[[File:Marked_as_published.png]]<br />
*[[File:New_blog_post.png]]<br />
*[[File:Save_as_a_draft.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/2_My_Files/Upload_a_File&diff=1211User Guide/2 My Portfolio/2 My Files/Upload a File2011-05-12T05:49:29Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Use the Upload File option to add an allowed file type to your repository. When attempting to upload a file you will always see the following Copyright notice: &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:copyright%20notice.png|copyright notice.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;In order to progress you must comply and agree to the Copyright notice by ticking the Copyright box. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Each file you upload includes the following fields in which information can be added:&lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Name&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; - You can add a title when uploading a file, otherwise it will default to the existing file name. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Description &lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;– You may choose to give your file a description.&lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tags - &lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You can add tags to Artefacts and Views you create within Mahara. Tags allow you to add descriptive labels to Artefacts and Views and create an index of tag classifications.&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt;&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Once you have added the required fields, click Upload to add the file to your repository area. When this is completed you will see an onscreen notification. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;If you attempt to upload a file with the same name as an existing Artefact in your repository area, you will be given the option of overwriting the existing file, renaming the new file or cancelling the upload process. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;To upload an audio or video file for embedding&lt;/font&gt;&lt;/span&gt;===<br />
<br />
Flowplayer only allows .mp3, .mp4 and .flv files for embedding in a view.<br />
<br />
Flowplayer only accepts file extensions with lower-case letters. Changing the file extension to lower-case in Mahara does not help.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;To upload a zip file and unzip to Mahara&lt;/font&gt;&lt;/span&gt;===<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt; Upload the zip file as above – files supported include zip, tar.gz and .tar.bz2&lt;br /&gt; The file will appear in the file list with the '''Unzip''' link beside it.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt; Click on the '''Unzip''' link &lt;br /&gt; A list of the files, Folders and Space Required is shown&lt;br /&gt; Select the '''Unzip''' button&lt;br /&gt; All the files and folders will be created and copied into the users My Files area on Mahara.&lt;br /&gt;&lt;br /&gt;&lt;br /&gt;&lt;/font&gt;&lt;/span&gt;&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;br /&gt;&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Copyright_notice.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/2_My_Files/Tags&diff=1210User Guide/2 My Portfolio/2 My Files/Tags2011-05-12T05:49:25Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tags allow you to include a user defined classification scheme for your Artefacts and Views. You can add individual words, or phrases. Multiple tags can be added and must be separated by a Comma. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;For example if your artefact was a Biology assignment you might add the following tags: &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Biology, Assignment, Semester 1 &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font color=&quot;red&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tip&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;span&gt; &lt;/span&gt;- When you next go to upload an Artefact, you can click on '''Show my tags''' to view a list of all tags you have previously used. This can save time if you need to frequently upload Artefacts with the same tags. Simply click on any relevant existing tags, and they will be added to your new Artefact. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Over time your tags list will develop into a comprehensive list of keywords for your Artefacts and will aid the search process. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Each file you upload includes the following fields in which information can be added:&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt;'''Name '''- You can add a title when uploading a file, otherwise it will default to the existing file name. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt;'''Description''' – You may choose to give your file a description.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt;'''Tags''' - You can add tags to Artefacts and Views you create within Mahara. Tags allow you to add descriptive labels to Artefacts and Views and create an index of tag classifications.&lt;br /&gt; &lt;br /&gt; Once you have added the required fields, click Upload to add the file to your repository area. When this is completed you will see an onscreen notification. &lt;br /&gt; If you attempt to upload a file with the same name as an existing Artefact in your repository area, you will be given the option of overwriting the existing file, renaming the new file or cancelling the upload process. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt; Tags have been improved to make it easier to create descriptive tags and search for artefacts based on their tags. The tagged content in mahara has been organised into Files, Images, Text, Views areas.&lt;br /&gt; Using Search Mahara you can find all of the Artefacts and Views you have associated with a particular Tag, thereby creating a filing system or index for your portfolio.&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt; Creating Tags&lt;/font&gt;&lt;/span&gt;===<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;br /&gt; Select the Artefact and select Edit&lt;br /&gt; Change type in the tag name&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;To add an existing tag select the Show my tags link above and then click on the tag that you want to use. You can add multiple tags for each artefact – separate each tag with a comma.&lt;br /&gt;&lt;br /&gt;'''Organising tags'''&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;There is a tag block on the right hand column that has all your tags shown&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;[[Image:tags.png|tags.png]]&lt;br /&gt;&lt;br /&gt; This is a tag cloud where the tags that have been used more have a larger font size.&lt;br /&gt; Click on the Tags link above to get the following screen which helps organise the tags.&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;[[Image:tag%20search.png|tag search.png]]&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;'''Edit Tags'''&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;This lets you change or delete a tag that has been used in your artefacts&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;[[Image:taggs%20edit.png|taggs edit.png]]&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;'''Managing tags'''&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;To help manage your tags you can sort your tags alphabetically, by frequency &lt;/font&gt;&lt;br /&gt;&lt;br /&gt;<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Tag_search.png]]<br />
*[[File:Taggs_edit.png]]<br />
*[[File:Tags.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/2_My_Files&diff=1209User Guide/2 My Portfolio/2 My Files2011-05-12T05:49:18Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The My Files area is a repository and document store for folders and files to use within your portfolio. Both folders and files are considered Artefacts and as such can be added to a View. You may create any number of folders or sub folders. To view which sub-folders and files sit within a folder, click on the folder name. Use the Home link to return to the top level folder directory. Files and folders can be rearranged by dragging and dropping them to other folders. A suitably named and organised filing structure will help with the long term organisation and retrieval of your Artefacts. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You will find that some folders are automatically created by the system such as ‘Blogfiles’. This folder includes files that are uploaded via a Blog posting. Deleting a file here will remove it from you Blog posting. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:my%20files.png|my files.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The file management interface has been changed in v1.2 to &lt;br /&gt;&lt;/font&gt;&lt;/span&gt;<br />
<br />
* &lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;allow the uploading of multiple files&lt;/font&gt;&lt;/span&gt;<br />
* &lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;uploading of zip files and unzipping these in mahara. &lt;br /&gt;&lt;/font&gt;&lt;/span&gt;<br />
* &lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;drag and drop Files to folders&lt;br /&gt;&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;The files that you are able to access are now organised into four different areas &lt;/font&gt;<br />
<br />
* &lt;font size=&quot;larger&quot;&gt;My Files - files belonging to you&lt;/font&gt;<br />
* &lt;font size=&quot;larger&quot;&gt;Group files – files belonging to groups you belong to&lt;/font&gt;<br />
* &lt;font size=&quot;larger&quot;&gt;Institution Files – files belonging to the institution you belong to&lt;/font&gt;<br />
* &lt;font size=&quot;larger&quot;&gt;Site Files – files belonging to the myportfolio site&lt;/font&gt;<br />
<br />
&lt;font size=&quot;larger&quot;&gt;You can use any files you have access to in views you create.&lt;/font&gt;&lt;br /&gt;<br />
<br />
===Files===<br />
<br />
*[[File:My_files.png]]<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/2_My_Portfolio/2_My_Files/Create_a_Folder|Create a Folder]]<br />
* [[User_Guide/2_My_Portfolio/2_My_Files/Tags|Tags]]<br />
* [[User_Guide/2_My_Portfolio/2_My_Files/Upload_a_File|Upload a File]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/1_My_Views/Editing_an_existing_View&diff=1208User Guide/2 My Portfolio/1 My Views/Editing an existing View2011-05-12T05:49:03Z<p>WikiSysop: </p>
<hr />
<div>Once a view has been created you will see it listed when you select &lt;br /&gt;'''My Portfolio -&amp;gt;My Views'''<br />
<br />
'''[[Image:viewlist.png|viewlist.png]]'''<br />
<br />
This has the following options<br />
<br />
* Create view – create a new view with the 3 step wizard above<br />
* Create template – this is a view that you can allow someone to copy<br />
* Copy a view – this is to copy a view that someone has allowed you to copy, all the files used in the view are copied too<br />
* Edit View details – change the view description<br />
* Edit this View – change the view layout with the drag and drop interface<br />
* Edit View Access – change who can see the view<br />
* Delete this view<br />
<br />
===Files===<br />
<br />
*[[File:Viewlist.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/1_My_Views/Create_View_Step_four:_Assign_Access_to_View&diff=1207User Guide/2 My Portfolio/1 My Views/Create View Step four: Assign Access to View2011-05-12T05:48:59Z<p>WikiSysop: </p>
<hr />
<div>No one is able to see your view until you give them access. You can give access in different combinations:<br />
<br />
* Public - anyone with internet access<br />
* Logged in Users - anyone who has a Mahara account<br />
* Friends - people who you have added as Friends on Mahara<br />
* Secret URL - anybody to whom you send this secret Web address<br />
* to individuals<br />
* to Groups<br />
* for a fixed period of time<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===To give access to your View to an individual User or a Group===<br />
<br />
# Locate the Search box<br />
# Use its pulldown menu to set the search to Groups or individual Users<br />
# Enter their name and select the Search button (n.b. it doesn't work to press the Enter key)<br />
# From the results, find the person or Group you wish to give access to<br />
# Select the Add button adjacent to each.<br />
# If necessary, restrict their access to a certain dates<br />
# When you are ready, remember to Save&lt;br /&gt;&lt;br /&gt;[[Image:scrnsht_view_access.png|scrnsht_view_access.png]]<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Overriding Start/Stop Dates===<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;You might have set different access dates for different users, but decide later that you want to configure all your dates in one go. To do this, go to the bottom of the view screen and select Overriding Start/Stop Dates&lt;/font&gt;<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
===Submitting a View (Controlled Groups only)===<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;If you are preparing a View as part of an assessed task and you have been added as a member of a Controlled Group, you will be able to submit your View for assessment.&lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;Go to My Views, choose a View and choose Submit this View to the relevant Group in the drop down box.&lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana, sans-serif&quot;&gt;This will lock the View title, layout and uploaded Artefacts. Note that it will not lock contact details and Blog posts. Your View can them be marked by a tutor and released back to you with any comments.&lt;/font&gt;<br />
<br />
&lt;div id=&quot;section_4&quot;&gt;<br />
<br />
========<br />
<br />
&lt;/div&gt;&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Create_view_access.png]]<br />
*[[File:My_views.jpg]]<br />
*[[File:Scrnsht_view_access.png]]<br />
*[[File:Start_stop_dates.png]]<br />
*[[File:View_access.jpg]]<br />
*[[File:View_access_dates.jpg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/1_My_Views/Create_a_View_Step_two:_Layout&diff=1206User Guide/2 My Portfolio/1 My Views/Create a View Step two: Layout2011-05-12T05:48:55Z<p>WikiSysop: </p>
<hr />
<div>[[Image:scrnsht_view_details.png|scrnsht_view_details.png]]<br />
<br />
# Enter a brief and meaningful Title for your View<br />
# Enter a brief and meaningful Description of your View, for the index of Views<br />
# Tags are optional keywords, separated by commas. To choose tags, try to anticipate what keywords you and others might use to search for this View in the future.<br />
# Name Display format – your View can display your name in different ways.<br />
# When you are ready to proceed to configure the access settings for your View, click the Next button.<br />
<br />
===Files===<br />
<br />
*[[File:Scrnsht_view_details.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/1_My_Views/Create_a_View_Step_one:_Details&diff=1205User Guide/2 My Portfolio/1 My Views/Create a View Step one: Details2011-05-12T05:48:51Z<p>WikiSysop: </p>
<hr />
<div>Feel free to experiment in Mahara - anything you create you can easily edit or delete.<br />
<br />
You may want to create your View in a Group if it is a collaborative creation, but for the purposes of this guide, let's assume we are creating a View for which you are the sole author in your Portfolio as follows:<br />
<br />
# Click on '''My Portfolio'''<br />
# Your Portfolio loads, with the Views tab displayed<br />
# Click the Create View button<br />
# An editable layout loads, with a row of tabs enabling you to add different types of content - these draggable elements are called '''Blocks'''<br />
# Look carefully at the page, note the links and the instructions<br />
# Let's now select a Block with your mouse and drag it below the line to the location you want it to appear in the View.<br />
# You can do this with any of the Blocks from any tabs<br />
# Note the link to '''Change My View layout '''&lt;br /&gt; Click on this to change the number of columns and width of the columns that the blocks will fit into. &lt;br /&gt; Click Next and you can select column width layout.&lt;br /&gt;[[Image:view%20layouts.png|view layouts.png]]&lt;br /&gt;&lt;br /&gt; When the view looks Ok then select Change My View Layout to return to your new View layout.<br />
# When you have finished adding Blocks of content, click Next to proceed<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Please note:===<br />
<br />
* The &quot;Embedded Media&quot; blocktype will only display certain file types, which are chosen from [http://mahara.org/interaction/forum/topic.php?id=1235#post6083 this list] by your site adminstrator.<br />
<br />
&lt;br /&gt;<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Create_view_step_1.jpg]]<br />
*[[File:Create_view_step_one.png]]<br />
*[[File:View_layouts.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/1_My_Views/Create_a_View/External_RSS_feeds&diff=1204User Guide/2 My Portfolio/1 My Views/Create a View/External RSS feeds2011-05-12T05:48:47Z<p>WikiSysop: </p>
<hr />
<div>&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===What is an RSS 'feed'?===<br />
<br />
CommonCraft have produced a really clear introduction: [http://www.commoncraft.com/rss_plain_english RSS in plain English].<br />
<br />
Contemporary websites are not static but change frequently as new pages are added. Before feeds were invented, we had to repeatedly check a given web site for changes, which required us to maintain an awareness of what the site contained before so that we could recognise the new content.<br />
<br />
These days, many sites 'feed' content, allowing us to 'aggregate' updates to, say, blogs (including your Mahara blog if you have one), news sites and social networking services in a 'feed reader'.<br />
<br />
(In case you were wondering, 'RSS' stands for 'really simple syndication.)<br />
<br />
[[Image:icon_feed.png|icon_feed.png]]<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===How do I find a feed?===<br />
<br />
One way to find a feed is to look for a link to RSS either on the page, or in your Web browser's address bar. It may look like this:<br />
<br />
Once you have arrived on the page (it will look like a list of items with titles) then copy its Web address from your Web browser's address bar. You'll paste this in the next stage.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
===And in Mahara?===<br />
<br />
In Mahara, you display feeds within a block in a View.<br />
<br />
External (non-Mahara) RSS feeds can be included in a View, as well as any Mahara blog configured to be accessed that way.<br />
<br />
Add an RSS feed to a View as follows:<br />
<br />
# In your View's Edit mode, drag the RSS feed icon to your desired location<br />
# The Configuration dialog box then opens&lt;br /&gt;&lt;br /&gt;[[Image:scrnsht_rss.png|scrnsht_rss.png]]&lt;br /&gt; <br />
# Give it a brief and meaningful title<br />
# Paste the Web address of the feed into the Feed Location box (coloured red)<br />
# If you are feeding images, you may wish to check the Show Feed Items In Full box - this means that the images themselves will display, as well as their titles.<br />
# Remember to Save.<br />
# Preview your View to check everything is in order<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_4&quot;&gt;<br />
<br />
===Please note===<br />
<br />
* RSS feeds are always updated once every hour. The frequency can be changed but only directly in the database (the &quot;blocktype_cron&quot; table).<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Icon_feed.png]]<br />
*[[File:Scrnsht_rss.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio/1_My_Views&diff=1203User Guide/2 My Portfolio/1 My Views2011-05-12T05:48:35Z<p>WikiSysop: </p>
<hr />
<div>A View is a selection of Artefacts which you arrange and present to others, which may include:<br />
<br />
* selected files<br />
* resumé details<br />
* text (your added commentary, instructions or orientation)<br />
* third party embeds or links from the Web.<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Can Views be collaborative?===<br />
<br />
They can be - and whether they are or not will affect the way you create them.<br />
<br />
Basically:<br />
<br />
* If you are '''the only person working on the View''', you will probably want to create it '''within your Portfolio'''. If you are a member of a Group, you can then '''share '''that View with a Group (and allow copying, as appropriate).<br />
* Whereas if you are '''collaborating '''on a shared View, then you may prefer to start a Group which you and your collaborators can join, and create any '''collaborative Views within that Group'''.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===Who can see my View?===<br />
<br />
A view can be kept private or shared with any number of Groups or individuals as you wish. You may create as many different Views as you like and reuse your Artefacts, even giving them different titles for different audiences.<br />
<br />
Views can also be used to submit work for feedback or assessment to a Controlled Group.<br />
<br />
Click on the images below to see sample Views, or view the slideshow on the [http://mahara.org/ Mahara front page]<br />
<br />
[http://dev.mahara.org/view/view.php?id=4 [[Image:sample%20view%201.png|sample view 1.png]]][http://demo.mahara.org/view/view.php?id=478 [[Image:sample%20view%202.png|sample view 2.png]]]<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Sample_view_1.png]]<br />
*[[File:Sample_view_2.png]]<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Copying_Views_(new_v_1.1)|Copying Views]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Create_a_View|Create a View - overview]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Create_a_View_Step_one:_Details|Create a View Step one: Layout]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Create_a_View_Step_two:_Layout|Create a View Step two: Details]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Create_View_Step_four:_Assign_Access_to_View|Create a View Step three: Assign Access to View]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Editing_an_existing_View|Editing an existing View]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Placing_Feedback_on_a_view|Placing Feedback on a view]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Providing_a_Link_to_a_View|Linking or browsing to a View]]<br />
* [[User_Guide/2_My_Portfolio/1_My_Views/Submitting_a_View|Submitting a View]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/2_My_Portfolio&diff=1202User Guide/2 My Portfolio2011-05-12T05:48:32Z<p>WikiSysop: </p>
<hr />
<div>[[Image:my%20portfolio%20menu%20bar.png|my portfolio menu bar.png]]<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;It might be useful to consider the My Portfolio section of Mahara as your main personal repository of resources and information. In here, you can begin to add content to your ePortfolio, in the shape of uploaded resources, or Artefacts, Blogs within Mahara and store them in '''My Files''' and '''My Blogs'''. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When you decide to start sharing selected Artefacts, you can use '''My Views''' to begin packaging them up for presentation. &lt;/font&gt;&lt;/span&gt;<br />
<br />
===Files===<br />
<br />
*[[File:My_portfolio_menu_bar.png]]<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/2_My_Portfolio/1_My_Views|My Views - overview]]<br />
* [[User_Guide/2_My_Portfolio/2_My_Files|My Files]]<br />
* [[User_Guide/2_My_Portfolio/My_Blogs|My Blogs]]<br />
* [[User_Guide/2_My_Portfolio/Z_Export|Export]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/1_Profile/My_Skills&diff=1201User Guide/1 Profile/My Skills2011-05-12T05:48:28Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The My Skills area is divided into Personal, Academic and Work sections. Using the HTML editor within each box you can provide information relating to your Goals so that you may add them to a View. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When adding information to any of these fields remember to click Save.&lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:my%20skills.png|my skills.png]]&lt;/font&gt;&lt;/span&gt;'''<br />
<br />
&lt;font color=&quot;red&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Tip:&lt;/font&gt;&lt;/font&gt;&lt;font size=&quot;12pt&quot;&gt; Once you have prepared a resumé, you will need to add it to a View in order to share it with other people, such as potential employers. Read how to &lt;/font&gt;[[# Create a View|&lt;font size=&quot;12pt&quot;&gt;create a View&lt;/font&gt;]]&lt;font size=&quot;12pt&quot;&gt; and about &lt;/font&gt;[[# Content Types: Resum%C3%A9|&lt;font size=&quot;12pt&quot;&gt;resumé content types&lt;/font&gt;]]&lt;font size=&quot;12pt&quot;&gt; ''' '''&lt;/font&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''V1.3'''<br />
<br />
The My Skills menu has been moved to under the My Resume menu.<br />
<br />
===Files===<br />
<br />
*[[File:My_skills.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/1_Profile/My_Goals&diff=1200User Guide/1 Profile/My Goals2011-05-12T05:48:24Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The My Goals area is divided into '''Personal, Academic '''and''' Careers sections'''. Using the HTML editor within each box you can provide information relating to your Goals so that you may add them to a View. &lt;span&gt; &lt;/span&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When adding information to any of these fields remember to click Save. &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:my%20goals.png|my goals.png]]&lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;V1.3&lt;/font&gt;&lt;/span&gt;'''<br />
<br />
The My Goals menu has been moved to under the My Resume menu.<br />
<br />
===Files===<br />
<br />
*[[File:My_goals.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/1_Profile/5_My_Resum%C3%A9&diff=1199User Guide/1 Profile/5 My Resumé2011-05-12T05:48:21Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The resumé area allows you to build digital resumés or CVs which can be tailored and shared with different audiences. It is entirely optional which of the fields you complete and which of those you then make available through Mahara’s View structure. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:my%20resume.png|my resume.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;This area is divided into two sections – one for entering general information and one for details of your experience and qualifications. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;When adding information to any of these fields remember to click Save &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The General Information fields in My Resumé includes: &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Cover Letter&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – Use this space to introduce yourself or provide supplementary information related&lt;span&gt; &lt;/span&gt;to the purpose and audience with whom you are sharing&lt;span&gt; &lt;/span&gt;your resumé &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Interests&lt;span&gt; &lt;/span&gt;- &lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Here you can detail personal and/or professional interests''' '''&lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Contact information&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – Your Contact Information is taken directly and edited from where it is stored within your Profile. To add to or update your Contact Information, click on Edit Profile. Once you have entered in the required information, click on Edit My Résumé to return to your Résumé area. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Personal information &lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;– These optional fields allow you to include additional information about yourself &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;The experience and qualifications area includes: &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Employment history, Certifications, Accreditations and Awards, Books and publications &lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;and '''Professional Memberships '''. To add details to any of these sections, click on Add to expand to an area in which to add your details. After each entry remember to click Save. Entries display in reverse chronological order. &lt;/font&gt;&lt;/span&gt;<br />
<br />
[[Image:resume%20categories.png|resume categories.png]]<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
====V1.3====<br />
<br />
The &lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;My Resumé &lt;/font&gt;&lt;/font&gt;&lt;/span&gt; tabs have been reorganised into<br />
<br />
Introduction, Education &amp;amp; Employment, Achievements, Goals, Skills and interests<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:My_resume.png]]<br />
*[[File:Resume_categories.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/1_Profile/4_Profile_Icons&diff=1198User Guide/1 Profile/4 Profile Icons2011-05-12T05:48:16Z<p>WikiSysop: </p>
<hr />
<div>&lt;font size=&quot;medium&quot;&gt;The Profile Icons area allows you to upload images to use within your Profile and Views. Your Icons may be a picture of you or an avatar image of your choice. You may upload up to '''five''' profile icons here, and choose one to be displayed as your default icon at any one time. Your icons must be between 16x16 and 1024x1024 pixels in size.&lt;/font&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font size=&quot;medium&quot;&gt;Click on the Browse button to navigate to your picture then click Open. You can enter a Title or name of your picture if you wish. Once you have selected your picture click '''Upload.'''&lt;/font&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font size=&quot;medium&quot;&gt;If you have more than one icon uploaded, you can choose which picture to make your default. Your default image will appear on your Profile page&lt;/font&gt;&lt;font size=&quot;12pt&quot;&gt;. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;[[Image:profile%20icons.png|profile icons.png]]&lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Profile_icons.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/1_Profile/3_Edit_Profile&diff=1197User Guide/1 Profile/3 Edit Profile2011-05-12T05:48:12Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Edit Profile allows you to include the following information about yourself in the following fields:&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Name and student ID&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – These fields may be locked for editing by an administrator, depending on local settings of Mahara. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Preferred name&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; - Use this if you do not wish to display your full name. Your preferred name can be anything you like and replaces your full name display to all users except site administrators and staff. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Introduction&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – You may wish to write a brief introduction about yourself. The information you enter here will be searchable by other users. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Contact information&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – Here you can add various contact details such as postal address, any external Blogs you may have and personal website addresses.&lt;span&gt; &lt;/span&gt; &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;You can also add additional email addresses using the Add Email button. Once you have saved your profile a message will be sent to the new email address. This message will contain a link which once followed, will confirm your email address is valid. This confirmation email is valid for 24 hours only. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Messaging&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – Include details of any Instant messaging service you may use, such as Skype or Jabber. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;General&lt;/font&gt;&lt;/span&gt;'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt; – Indicate your profession and industry where relevant. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Remember to Save Profile before progressing &lt;/font&gt;&lt;/span&gt;'''<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:edit%20profile.jpg|edit profile.jpg]]&lt;/font&gt;&lt;/span&gt;'''<br />
<br />
===Files===<br />
<br />
*[[File:Edit_profile.jpg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/1_Profile/2_Edit_profile_page&diff=1196User Guide/1 Profile/2 Edit profile page2011-05-12T05:48:08Z<p>WikiSysop: </p>
<hr />
<div>This is where you can change the layout of your profile page – this can be done by dragging one of the blocks with the green plus sign to below the gray line that says drag blocks below this line to add them to your view layout. This is a similar process to editing a view.<br />
<br />
[[Image:edit%20profile%20view.png|edit profile view.png]]<br />
<br />
===Files===<br />
<br />
*[[File:Edit_profile_view.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/1_Profile&diff=1195User Guide/1 Profile2011-05-12T05:48:01Z<p>WikiSysop: </p>
<hr />
<div>&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;[[Image:profile%20menu%20bar.png|profile menu bar.png]]&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Your Profile area stores your contact and personal information. This is the area in Mahara where you can start to build up a picture of your interests, achievements, aims and when you are ready to do so, share them with other users. Always remember to think about your own personal security before releasing contact information on a publicly available View. &lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;Each of the Profile fields can be considered separate Artefacts which may be independently added to a View. &lt;/font&gt;&lt;/span&gt;<br />
<br />
'''&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;v1.3&lt;/font&gt;&lt;/span&gt;'''<br />
<br />
&lt;font size=&quot;larger&quot;&gt;&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt;The Edit profile page and View profile page have been moved to the '''My Portfolio &amp;gt; My Views''' menu . The profile page is actually a view so is better to be located with other views&lt;/font&gt;&lt;/span&gt;&lt;/font&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Profile_menu_bar.png]]<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/1_Profile/1_View_profile_page|View profile page]]<br />
* [[User_Guide/1_Profile/2_Edit_profile_page|Edit profile page]]<br />
* [[User_Guide/1_Profile/3_Edit_Profile|Edit Profile]]<br />
* [[User_Guide/1_Profile/4_Profile_Icons|Profile Icons]]<br />
* [[User_Guide/1_Profile/5_My_Resumé|My Resumé]]<br />
* [[User_Guide/1_Profile/My_Goals|My Goals]]<br />
* [[User_Guide/1_Profile/My_Skills|My Skills]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/0_Introduction/Logging_in&diff=1194User Guide/0 Introduction/Logging in2011-05-12T05:47:57Z<p>WikiSysop: </p>
<hr />
<div>&lt;font size=&quot;12pt&quot;&gt;Your login details will be the username and password you entered during registration or as assigned by your institution or Site Administrator. Where relevant, you will also need to select the institution with which you are associated. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
'''&lt;font size=&quot;12pt&quot;&gt;Your username may include alphanumeric characters, full stops and @ symbols. Your username must be between 3 and 30 characters long&lt;/font&gt;'''&lt;font size=&quot;12pt&quot;&gt;. Usernames are &lt;span&gt;not case sensitive&lt;/span&gt;. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;Your password must be at least six characters long and contain at least one digit and two letters. Your password may not be the same as your username and is &lt;span&gt;case sensitive&lt;/span&gt;. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;Once you have submitted the registration form, an email will immediately be sent to your email address. This email will contain a link which once followed, will confirm your account and log you into the system. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt;&lt;font size=&quot;12pt&quot;&gt;&lt;font face=&quot;Verdana&quot;&gt;If you do not receive an email confirmation message after registration, please ensure the registration message has not been caught by your email junk filter. Please contact the Site &lt;/font&gt;&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;&lt;font size=&quot;12pt&quot;&gt;Administrator if you have any problems registering. &lt;/font&gt;<br />
<br />
&lt;font size=&quot;12pt&quot;&gt;[[Image:login%20box.jpg|login box.jpg]]&lt;/font&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Login_box.jpg]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/0_Introduction/Contextual_help&diff=1193User Guide/0 Introduction/Contextual help2011-05-12T05:47:46Z<p>WikiSysop: </p>
<hr />
<div>You will find contextual help throughout Mahara, wherever you see the question mark symbol [[Image:icon_help.png|icon_help.png]]. Click on this to open a dialogue box containing help on the area you are currently working in. Contextual help is designed to help guide you through Mahara so please use this feature as much as you require.<br />
<br />
===Files===<br />
<br />
*[[File:Icon_help.png]]<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/0_Introduction/Contextual_help/Page_Title|Summary of mahara 1.3 interface changes]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide/0_Introduction&diff=1192User Guide/0 Introduction2011-05-12T05:47:42Z<p>WikiSysop: </p>
<hr />
<div>&lt;div class=&quot;content&quot;&gt;&lt;div class=&quot;wiki-content&quot;&gt;<br />
<br />
Welcome to the '''Mahara User Guide'''! This user guide is designed to provide documentation for people who will use Mahara on a day-to-day basis. '''This document is designed to be read by any user of Mahara''', as most users will have access to the features documented here. Site and Institution Administrators (will eventually) have separate user guides.<br />
<br />
Without any further ado, let's begin!<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
====What is Mahara?====<br />
<br />
If you're wondering what Mahara or an e-portfolio is, why you might want one and what it can do for you, then read on - you're about to find out.<br />
<br />
At the simplest level, Mahara is two things: an [http://en.wikipedia.org/wiki/Eportfolio e-portfolio] and a [http://en.wikipedia.org/wiki/Social_network social networking] system combined. An e-portfolio is a system in which students can record &quot;evidences of lifelong learning&quot; - such as essays, artwork or other such things they produce that can be stored digitally. Such things are known as '''artefacts''' in Mahara. Social networking systems need little introduction - think [http://www.myspace.com/ Myspace], [http://facebook.com/ Facebook] or [http://bebo.com/ Bebo]. Basically, they give a way for people to interact with their friends and create their own online communities.<br />
<br />
But Mahara is much more than just a place to store files. Mahara also includes blogging, a resumé builder, [http://moodle.org/ Moodle] integration and the standout views framework.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
====What are Views?====<br />
<br />
Views give students a way to display their artefacts in a way they choose, to the people they want to see them. For instance, a student could have one view that contains a journal of their progress and some notes for a project they are currently doing, visible only to their teachers. Also, they could have another view, showing photos from their holiday in Scotland, that their friends can see.<br />
<br />
This framework gives users tremendous flexibility in how their data is shown to others. Furthermore, they are not restricted to just placing artefacts in their views - Mahara allows users to insert Youtube videos, Flickr photos, RSS feeds and much more. And the entire framework is pluggable - so anything you imagine could become part of a view, simply by writing a new plugin.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
====The Mahara framework====<br />
<br />
&lt;font face=&quot;Verdana&quot;&gt;With Mahara, '''you '''control which items and what information within your portfolio other users see. Such items and information are termed artefacts. To facilitate this access control, all artefacts you wish to show to other users need to be arranged into one area. In Mahara this compilation of selected artefacts is called a View. You can have as many Views as you like, each with a different collection of artefacts, and intended purpose and audience. Your audience, or the people you wish to give access to your View, can be added as individuals or as a member of a Group. It can even be made publicly available.&lt;/font&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt; &lt;/font&gt;<br />
<br />
&lt;font face=&quot;Verdana&quot;&gt;For example you could create a View for your friend and family that includes holiday photos and a personal Blog. You could create another View for your tutor, which includes assessments and your reflective learning journal. You could create a third View to showcase your best pieces of work and your resumé for potential employers. In fact you can create as many Views as you wish for work, study and leisure purposes.&lt;/font&gt;<br />
<br />
The diagram below of example artefacts, Views and groups illustrates how content in Mahara can be shared and reused in different contexts and for different audiences.<br />
<br />
&lt;span style=&quot;line-height: 115%&quot;&gt;&lt;font face=&quot;&amp;quot;Calibri&amp;quot;,&amp;quot;sans-serif&amp;quot;&quot;&gt;&lt;font size=&quot;11pt&quot;&gt;[[Image:Mahara%20structure.png|Mahara structure.png]]&lt;/font&gt;&lt;/font&gt;&lt;/span&gt;<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_4&quot;&gt;<br />
<br />
====How does Mahara fit in to the e-learning landscape?====<br />
<br />
If you think of [http://en.wikipedia.org/wiki/Learning_Management_System LMS]es such as Moodle, Sakai and Blackboard as the formal, structured side of e-learning, then Mahara is the social, reflective side. An LMS and an e-portfolio complement one another in an online learning environment.<br />
<br />
In particular, while Mahara's APIs are open to all, Mahara can integrate with Moodle to provide a streamlined user experience. Currently this is limited to [http://en.wikipedia.org/wiki/Single_sign-on SSO], but from Moodle 2.0, students will be able to export assignments, blogs and much more straight into Mahara to use as artefacts (which can then, of course, be placed into views).<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_5&quot;&gt;<br />
<br />
====What if Mahara does not support a feature I want?====<br />
<br />
Mahara has been designed from the ground up to be an open, pluggable system. Creating new artefacts, authenticating against a custom system and much more can be implemented simply through writing a plugin that uses the appropriate core API. What this means is that it is free and easy for you to customise almost anything about Mahara to suit your needs - and [http://www.mahara.org/partners paid support is available] from the creators of Mahara should you require.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_6&quot;&gt;<br />
<br />
====Other things to do====<br />
<br />
Now you have a basic idea of what Mahara is, you could:<br />
<br />
* Read the [http://www.mahara.org/features list of features] that Mahara comes with<br />
* [http://demo.mahara.org/ Explore the demo] or [[Download Mahara|download mahara]] for yourself to play with<br />
* [http://mahara.org/registration.php Sign up to the mahara.org community] and being asking questions and contributing in the [http://mahara.org/forums forums] <br />
* Continue reading this user guide!<br />
<br />
&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Mahara_structure.png]]<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/0_Introduction/Contextual_help|Contextual help]]<br />
* [[User_Guide/0_Introduction/Definitions|Definitions]]<br />
* [[User_Guide/0_Introduction/Logging_in|Logging in]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=User_Guide&diff=1191User Guide2011-05-12T05:47:39Z<p>WikiSysop: </p>
<hr />
<div>If you're new to Mahara and don't know where to begin, you've found the right place! Here on mahara.org, and in particular in this section of the documentation, you can find out more about Mahara and ePortfolios, and how to begin using or contributing to Mahara.<br />
<br />
&lt;div class=&quot;wiki-tree&quot;&gt;<br />
<br />
* [[User Guide/0 Introduction|Introduction]]<br />
** [[User Guide/0 Introduction/Contextual help|Contextual help]]<br />
*** [[User Guide/0 Introduction/Contextual help/Page Title|Summary of mahara 1.3 interface changes]]<br />
** [[User Guide/0 Introduction/Definitions|Definitions]]<br />
** [[User Guide/0 Introduction/Logging in|Logging in]]<br />
* [[User Guide/1 Profile|Profile]]<br />
** [[User Guide/1 Profile/1 View profile page|View profile page]]<br />
** [[User Guide/1 Profile/2 Edit profile page|Edit profile page]]<br />
** [[User Guide/1 Profile/3 Edit Profile|Edit Profile]]<br />
** [[User Guide/1 Profile/4 Profile Icons|Profile Icons]]<br />
** [[User Guide/1 Profile/5 My Resum%c3%a9|My Resumé]]<br />
** [[User Guide/1 Profile/My Goals|My Goals]]<br />
** [[User Guide/1 Profile/My Skills|My Skills]]<br />
* [[User Guide/2 My Portfolio|My Portfolio]]<br />
** [[User Guide/2 My Portfolio/1 My Views|My Views - overview]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Copying Views (new v 1.1)|Copying Views]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Create a View|Create a View - overview]]<br />
**** [[User Guide/2 My Portfolio/1 My Views/Create a View/External RSS feeds|External RSS feeds]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Create a View Step one%3a Details|Create a View Step one: Layout]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Create a View Step two%3a Layout|Create a View Step two: Details]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Create View Step four%3a Assign Access to View|Create a View Step three: Assign Access to View]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Editing an existing View|Editing an existing View]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Placing Feedback on a view|Placing Feedback on a view]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Providing a Link to a View|Linking or browsing to a View]]<br />
*** [[User Guide/2 My Portfolio/1 My Views/Submitting a View|Submitting a View]]<br />
** [[User Guide/2 My Portfolio/2 My Files|My Files]]<br />
*** [[User Guide/2 My Portfolio/2 My Files/Create a Folder|Create a Folder]]<br />
*** [[User Guide/2 My Portfolio/2 My Files/Tags|Tags]]<br />
*** [[User Guide/2 My Portfolio/2 My Files/Upload a File|Upload a File]]<br />
** [[User Guide/2 My Portfolio/My Blogs|My Blogs]]<br />
*** [[User Guide/2 My Portfolio/My Blogs/Add a Blog Post|Add a Blog Post]]<br />
*** [[User Guide/2 My Portfolio/My Blogs/Add a file from My Files|Add a file from My Files]]<br />
*** [[User Guide/2 My Portfolio/My Blogs/Blog comments|Blog comments]]<br />
*** [[User Guide/2 My Portfolio/My Blogs/Create a Blog|Create a Blog]]<br />
*** [[User Guide/2 My Portfolio/My Blogs/Embed an image to a Blog post|Embed an image to a Blog post]]<br />
*** [[User Guide/2 My Portfolio/My Blogs/Upload a file to a Blog|Upload a file to a Blog]]<br />
*** [[User Guide/2 My Portfolio/My Blogs/View Blog|View Blog]]<br />
** [[User Guide/2 My Portfolio/Z Export|Export]]<br />
* [[User Guide/3 My Groups|Groups]]<br />
** [[User Guide/3 My Groups/Add members to groups|Add members to groups]]<br />
** [[User Guide/3 My Groups/Create groups|Create groups]]<br />
** [[User Guide/3 My Groups/Find Groups|Find and join a Group]]<br />
** [[User Guide/3 My Groups/Friends|Friends]]<br />
*** [[User Guide/3 My Groups/Friends/Control how friends are added|Control how friends are added]]<br />
*** [[User Guide/3 My Groups/Friends/Find friends|Find friends]]<br />
** [[User Guide/3 My Groups/Group Forums|Group Forums]]<br />
*** [[User Guide/3 My Groups/Group Forums/Create forum|Add a Forum]]<br />
*** [[User Guide/3 My Groups/Group Forums/Create New Topic|Create New Topic]]<br />
*** [[User Guide/3 My Groups/Group Forums/Editting topics|Editting topics]]<br />
*** [[User Guide/3 My Groups/Group Forums/Replying to a Topic indenting|Replying to a Topic indenting]]<br />
*** [[User Guide/3 My Groups/Group Forums/Selecting actions for forum topics|Selecting actions for forum topics]]<br />
** [[User Guide/3 My Groups/Viewing group details|Viewing group details]]<br />
* [[User Guide/4 Settings|Settings]]<br />
** [[User Guide/4 Settings/1 Preferences|Preferences]]<br />
** [[User Guide/4 Settings/2 Notifications|Notifications]]<br />
** [[User Guide/4 Settings/Activity Preferences|Activity Preferences]]<br />
** [[User Guide/4 Settings/Institution Membership|Institution Membership]]<br />
* [[User Guide/Tutorials about Mahara|Tutorials about Mahara]]<br />
* [[User Guide/User Guide As One Page|Mahara User's Guide combined - including micro manuals]]<br />
** [[User Guide/User Guide As One Page/Administrator micro manual|Administrator micro manual]]<br />
** [[User Guide/User Guide As One Page/Mahara%2f%2fMoodle outcomes micro manual|Mahara/Moodle outcomes micro manual]]<br />
** [[User Guide/User Guide As One Page/User cheat sheet|User micro manual]]<br />
<br />
&lt;/div&gt;<br />
<br />
===Subpages===<br />
<br />
* [[User_Guide/0_Introduction|Introduction]]<br />
* [[User_Guide/1_Profile|Profile]]<br />
* [[User_Guide/2_My_Portfolio|My Portfolio]]<br />
* [[User_Guide/3_My_Groups|Groups]]<br />
* [[User_Guide/4_Settings|Settings]]<br />
* [[User_Guide/Tutorials_about_Mahara|Tutorials about Mahara]]<br />
* [[User_Guide/User_Guide_As_One_Page|Mahara User's Guide combined - including micro manuals]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=System_Administrator%27s_Guide/Next_Steps&diff=1190System Administrator's Guide/Next Steps2011-05-12T05:47:17Z<p>WikiSysop: </p>
<hr />
<div>After you've installed your Mahara, you might be wondering what you can do next. Here are some suggestions that may give you some ideas. Though feel free to dive in and play if you like!<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
==Register on mahara.org==<br />
<br />
[[Image:register-your-mahara.png|register-your-mahara.png]]When you visit the administration section for the first time, you'll be presented with the option of registering on mahara.org. You certainly don't have to, but registering helps us gather a picture of how Mahara usage is growing around the world :). No information that would personally identify any of your users will be sent to us, and it doesn't cost any money to register.<br />
<br />
To register, simply click the &quot;Register&quot; button you see on the administration homepage.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
==Install a Language Pack==<br />
<br />
Mahara ships only with an English language pack, but you can download and install support for other languages. You install language packs in a subdirectory of your dataroot directory, called &quot;langpacks&quot;.<br />
<br />
To install a language pack:<br />
<br />
# Make sure you have a &quot;langpacks&quot; directory inside your dataroot directory - one should have already been created for you.<br />
# Download the language pack you want to install from the [[Language Packs|language packs page]].<br />
# Decompress the downloaded TGZ archive.<br />
# Copy the obtained directory to the 'langpacks' directory inside your dataroot.<br />
# If the directory you put inside the dataroot 'langpacks' directory has a name like 'mahara-lang-xy', rename it to 'xy.utf8'.<br />
<br />
Now you will be able to visit the Site Administration of your Mahara and choose the appropriate default language. Users will also be able to choose what language they see in their settings.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_3&quot;&gt;<br />
<br />
==Install a Theme==<br />
<br />
[[Image:sunset-theme.png|sunset-theme.png]]Mahara 1.2 ships with six themes, and [[Themes|you can download more]].<br />
<br />
To install, download a theme, then extract it in Mahara's 'theme' directory. You will then be able to go to the Site Options page and choose a default theme for the site.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_4&quot;&gt;<br />
<br />
==Browse the Plugins==<br />
<br />
Mahara has a [[Plugins|growing list of plugins]]. Have a look through them, and see if any would be suitable for your installation.<br />
<br />
To install, download a plugin, then decompress it in the appropriate plugin type directory. For example, if you download an artefact plugin, decompress it in the 'artefact' subdirectory.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_5&quot;&gt;<br />
<br />
==Fill out your Profile==<br />
<br />
If you're going to be using the admin account for day-to-day use, fill out your profile, as an example for other users. You should also edit your Profile Page, and change its layout to suit you using the drag &amp;amp; drop system. Also, you could upload a profile icon so others will easily recognise your content throughout the system.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_6&quot;&gt;<br />
<br />
==Set up Moodle Integration==<br />
<br />
[[Image:mahoodle.jpg|mahoodle.jpg]]Do you have a Moodle installation that you want to link with your new Mahara? Check out the [[System Administrator's Guide/Moodle%2f%2fMahara Integration|instructions for integrating Mahara and Moodle]].<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_7&quot;&gt;<br />
<br />
==Start Building your Portfolio==<br />
<br />
With all that &quot;admin&quot; stuff out the way, it's time to play! Start a blog, fill out your resume, upload some files and start creating your portfolio!<br />
<br />
&lt;/div&gt;<br />
<br />
===Files===<br />
<br />
*[[File:Mahoodle.jpg]]<br />
*[[File:Register-your-mahara.png]]<br />
*[[File:Sunset-theme.png]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=System_Administrator%27s_Guide/Moodle//Mahara_Integration/View_Submission&diff=1189System Administrator's Guide/Moodle//Mahara Integration/View Submission2011-05-12T05:47:13Z<p>WikiSysop: </p>
<hr />
<div>You can install two plugins for Moodle 1.9 that will allow Mahara users to submit their Mahara Views to a Moodle course for assessment.<br />
<br />
The first is an ordinary Moodle module, and just sets up some mnet functions to<br />
<br />
# get listings of a user's Mahara views within Moodle,<br />
# submit a Mahara view to the Moodle mnet host (rather than to a Mahara group)<br />
<br />
The second plugin is a Moodle assignment type which provides the interface for the student to choose the view to submit, and which allows the teacher to grade the submitted view.<br />
<br />
More detailed steps below:<br />
<br />
# You need a Moodle 1.9/Mahara 1.2 pair already set up with SSO in the Moodle -&amp;gt; Mahara direction.<br />
# Untar [http://gitorious.org/mahara-contrib/mdl19-mod-mahara/archive-tarball/master mahara-contrib-mdl19-mod-mahara-master.tar.gz], [http://gitorious.org/mahara-contrib/mdl19-mod-assignment-type-mahara/archive-tarball/master mahara-contrib-mdl19-mod-assignment-type-mahara-master.tar.gz] into the Moodle.<br />
# Log into Moodle as administrator and visit /admin (installs the mnet functions).<br />
# In the admin section, visit Networking -&amp;gt; Peers Click on your mahara host, and then on the Services tab. Under Mahara assignment mnet module, check Subscribe, and save changes.<br />
<br />
Teachers should now be able to select the &quot;Mahara Portfolio&quot; assignment from the Activity drop-down in the Moodle courses.<br />
<br />
If you intend to grade the Mahara View assignments using Outcomes, and you would like students to be able to keep track of the Outcomes for their Views on the Mahara side, you can do this with the Mahara Outcomes artefact plugin:<br />
<br />
# Untar [http://gitorious.org/mahara-contrib/plugin-artefact-outcome/archive-tarball/master mahara-contrib-plugin-artefact-outcome-master.tar.gz] into the Mahara.<br />
# In mahara, log in as the mahara admin, go to Site Administration -&amp;gt; Administer Extensions, and click the &quot;Install&quot; link beside the &quot;outcome&quot; artefact plugin.<br />
<br />
This adds a &quot;My Outcomes&quot; tab under the My Portfolio menu.<br />
<br />
User documentation is available in the [[User Guide/User Guide As One Page/Mahara%2f%2fMoodle outcomes micro manual|Mahara/Moodle outcomes micro manual]].<br />
<br />
These plugins were funded through a grant from the [http://www.ed.state.nh.us/ New Hampshire Department of Education] to a collaborative group of the following New Hampshire school districts:<br />
<br />
* [http://sau16.org/ Exeter Region Cooperative]<br />
* [http://windhamsd.org/ Windham]<br />
* [http://www.orcsd.org/ Oyster River]<br />
* [http://sau61.org/ Farmington]<br />
* [http://www.newmarket.k12.nh.us/ Newmarket] <br />
* [http://www.timberlane.net Timberlane School District]</div>WikiSysophttps://wiki.mahara.org/index.php?title=System_Administrator%27s_Guide/Moodle//Mahara_Integration&diff=1188System Administrator's Guide/Moodle//Mahara Integration2011-05-12T05:47:10Z<p>WikiSysop: </p>
<hr />
<div>[[Image:mahoodle.jpg|mahoodle.jpg]]The integration between Moodle and Mahara has been affectionately named &quot;Mahoodle&quot;. It allows true single-signon between both systems - no password sharing required, and users' profile information is ported across. In addition, from Mahara 1.2, users will be able to [[System Administrator's Guide/Moodle%2f%2fMahara Integration/View Submission|submit Mahara Views to Moodle for assessment]] (with a plugin for Moodle).<br />
<br />
The best instructions for setting up the integration can be found in the 3.1MB PDF entitled &quot;Mahoodle&quot;, which you can find attached to this wiki page. The instructions and screenshots are a little out of date, but the process works.<br />
<br />
More up to date instructions and screenshots are available in the mahoodle-updated-en.odp and mahoodle-updated-en.pdf files attached to this wiki page. You should also read the original Mahoodle.pdf file to get more detailed explanations about the whole process.<br />
<br />
===Files===<br />
<br />
*[[File:Mahoodle.pdf]]<br />
*[[File:Mahoodle-updated-en.odp]]<br />
*[[File:Mahoodle-updated-en.pdf]]<br />
<br />
===Subpages===<br />
<br />
* [[System_Administrator's_Guide/Moodle//Mahara_Integration/View_Submission|Mahara-Moodle View Submission]]</div>WikiSysophttps://wiki.mahara.org/index.php?title=System_Administrator%27s_Guide/Installing_Mahara/Troubleshooting&diff=1187System Administrator's Guide/Installing Mahara/Troubleshooting2011-05-12T05:47:05Z<p>WikiSysop: </p>
<hr />
<div>Here is a list of common questions and problems people have while installing Mahara. There is a [http://mahara.org/interaction/forum/topic.php?id=680 list of common problems in the forums] that might also help you.<br />
<br />
'''Q: I just see 500 Internal Server Errors when trying to load pages'''<br />
<br />
'''A:''' This is probably because you are on shared hosting and your host has disabled some directives within .htaccess files, or possibly even disabled the use of .htaccess itself.<br />
<br />
The .htaccess file lives in the htdocs/ directory. It is a &quot;hidden&quot; file (because of the . at the start of its name), that tells Apache how it should behave. Mahara uses it to turn off dangerous PHP settings and configure caching so that your Mahara site performs quickly. Unfortunately, if your host has disabled .htaccess then you will lose some or all of these benefits.<br />
<br />
To resolve the issue, first comment out any line that starts with php_flag or php_value in the file, and try loading the page again. If that still doesn't work, completely remove the .htaccess file.<br />
<br />
If you're still running into issues, you will need to check your apache error log. The log should have an error message in it telling you exactly why you're getting the 500 Internal Server Error. Mosts hosts provide at least rudimentary access the logs. If they don't, consider switching, because a host where you can't find out what's wrong is not providing you with an acceptable minimum of service.<br />
<br />
'''Q: Upon successful install, I see messages like You have dangerous PHP settings, magic_quotes_gpc is on. Mahara is trying to work around this, but you should really fix it'''<br />
<br />
'''A:''' These messages warn you about PHP settings that you should have disabled. Mahara tries to disable them via .htaccess. If this has not worked, then you're probably on shared hosting, and need to tell Mahara to disable the messages. In your &lt;code&gt;config.php&lt;/code&gt;, find this line:<br />
<br />
$cfg-&amp;gt;log_environ_targets = LOG_TARGET_SCREEN | LOG_TARGET_ERRORLOG;<br />
<br />
and change it to<br />
<br />
$cfg-&amp;gt;log_environ_targets = 0;<br />
<br />
'''Q: I see this:'''<br />
<br />
'''Parse error: syntax error, unexpected '{' in .../htdocs/init.php on line 79'''<br />
<br />
'''A:''' You're probably running Mahara on PHP4. Mahara requires PHP 5.1 or greater.<br />
<br />
'''Q: Every page I go to, Mahara wants me to log in again!'''<br />
<br />
'''A:''' There's two possibilities:<br />
<br />
# You could have set up a Server Alias for Mahara. This is a mistake.People use ServerAlias to make their sites respond to both example.org and www.example.org. The problem with this, in the context of Mahara, is that Mahara has a wwwroot setting which is where it expects to be run from. That is, Mahara expects to always be run from exactly the same domain name.This is for a couple of reasons. Firstly, SSL keys for MNET are generated by hostname, so having your site respond on more than one hostname means that MNET communications on the other hostnames will break - leading to an inconsistent &quot;flaky&quot; MNET experience for your users. Secondly, cookies can be set for just the one domain, preventing the issue where you log in at www.example.org then end up on example.org, not logged in.You can still provide any number of aliases - but you should do it with an extra VirtualHost instead of many ServerAliases. Here is an example of how to do it right: &lt;font size=&quot;1em&quot;&gt;<br />
ServerName example.org<br />
# Definitely, absolutely, NO ServerAliases in here<br />
DocumentRoot /path/to/mahara/htdocs<br />
<br />
<br />
ServerName www.example.org<br />
# NOTE: ServerAliases are OK in this vhost block - if a client hits<br />
# any host in this block they'll be redirected to the &quot;main&quot; wwwroot<br />
ServerAlias mahara.example.org<br />
Redirect permanent / http://example.org/<br />
<br />
&lt;/font&gt;<br />
# Another possibility (less likely) is that you have specified your dataroot incorrectly. Dataroot is an '''absolute path relative to the filesystem'''. It is NOT a URL, or part of one. It will also NOT work if it is a relative path.To work out where on the filesystem your Mahara is installed, if you can't find it some other way (like FTP), put a line in index.php like &lt;code&gt;echo getcwd();&lt;/code&gt;.Your dataroot path then needs to be placed according to the normal rules, as documented in config-dist.php.<br />
<br />
'''Q: My server will not allow PHP to send emails except through SMTP, how do I configure and test this?'''<br />
<br />
'''A:''' The following process will step you through configuring and testing your SMTP based email messaging from a Mahara 1.1.1 installation:<br />
<br />
1. First thing you need to do is look at the contents of the config-default.php, found in the root folder of your Mahara site. Copy the following lines to your main config.php file and modify the three SMTP settings according to how your server or hosting service is set up:<br />
<br />
&lt;blockquote&gt;<br />
<br />
// mail handling -- copied this over from config-defaults.php 3/8/2009 so I can use smtp email&lt;br /&gt; // if you want mahara to use smtp servers to send mail, enter one or more here&lt;br /&gt; // blank means mahara will use the default PHP method.&lt;br /&gt; $cfg-&amp;gt;smtphosts = 'smtp.youremailhost.com';&lt;br /&gt; // If you have specified an smtp server above, and the server requires authentication, &lt;br /&gt; // enter them here&lt;br /&gt; $cfg-&amp;gt;smtpuser = 'youremailuser'; &lt;br /&gt; $cfg-&amp;gt;smtppass = 'youremailpassword';<br />
<br />
&lt;/blockquote&gt;<br />
<br />
The last two lines should be used only if you need authentication, otherwise comment them both out with //<br />
<br />
2. Once that is set up, verify that you can send emails from that SMTP server BEFORE you even bother trying to test any emails from your Mahara site. When you create an mailbox on your hosting service's email server, you specified a user name and a password. Using your services webmail or other similar service, log into your SMTP mailbox and send a test email to anther email account, let's say a gmail account. Once you are able to do that successfully, only then proceed with the following.<br />
<br />
3. Your emails are not sent automatically from your Mahara site, instead they are lined up and sent at various times by a built-in cron system. The instructions have already covered how to set up the cron on your server to hit your Mahara's cron system every minute, which in turn triggers its own built-in cron programs. Since this is a new install, you may not be sure if cron is working correctly. If you have email problems, it can be confusing to determine which is at fault, the SMTP or the cron or both. You can first try manually hitting your Mahara's cron system by typing the following:<br />
<br />
'''/usr/bin/curl -s -v http://yoursite/lib/cron.php '''<br />
<br />
Note that the above uses the -v or verbose flag to show you what it is doing. It should show you connecting to your site's cron.php file.<br />
<br />
A typical cron system on a hosting service can be edited with a command such as:<br />
<br />
&lt;blockquote&gt;<br />
<br />
'''EDITOR=nano crontab -e'''<br />
<br />
&lt;/blockquote&gt;<br />
<br />
That will bring up your cron file in the easy-to-use nano editor, which may start out empty if you have never added anything to it before. If that does not work, check with yoru hosting service to find out their specific procedure. If that or similar command gets you into an edtor, type the following line:<br />
<br />
&lt;nowiki&gt;* * * * * /usr/bin/curl -s &lt;/nowiki&gt;http://yoursite/lib/cron.php<br />
<br />
Save the file by hitting the key sequence and then exit teh editor by hitting the key sequence.<br />
<br />
4. Now that it appears that a working cron is configured, the best way to test the Mahara email is by sending yourself a message through the contact us form. The reason is that it is triggered very quickly by Marhara's cron system, and should therefore be sent to your admin user's email address within a minute or so. Note that other emails from the system, like notifications on new forum posts, can take a much longer time to be triggered by Mahara's cron.<br />
<br />
5. If it does not work after giving it sufficient time to be triggered, sent, and received, the things to check are:<br />
<br />
a. Make sure your admin email account is working - send it a test message from a gmail account or some other account.<br />
<br />
b. If it is working, check the junk or spam folders for your contact us messages - they have been flagged before they got to your inbox.<br />
<br />
c. Logged in as your admin user, click on the Profile tab in the menu, then click the settings button on the right (by the user picture), then click Notifications in the submenu. This should have a copy of all incoming messages of all types for the admin user. See if your messages are showing up in there correctly.<br />
<br />
d. Begin checking and changing the settings we already made for the SMTP and the cron. Manually trigger the cron after each setting change, then retest the contact us form. Then recheck your email inbox, spam, and also the Notifications log. Repeat until your figure out the problem, which is probably a typo or something like authentication settings for the SMTP.<br />
<br />
e. If you work systematically , making notes as you go through each combination your have tried, it will be easier to debug the problem and/or ask for help in the forums. In the forums, give enough detail of your settings and tests, but do not compromise your passwords.<br />
<br />
&lt;span class=&quot;Apple-style-span&quot; style=&quot;line-height: normal&quot;&gt; &lt;/span&gt;<br />
<br />
'''Q: My installation hangs and never finishes'''<br />
<br />
'''A:''' Your installation is probably exceeding PHP's '''max_execution_time''' limit. To fix open your '''php.ini''' file and change the following line:<br />
<br />
max_execution_time = 30<br />
<br />
to:<br />
<br />
max_execution_time = 120<br />
<br />
<br />
then restart your Apache server. You can reset this variable once installation is complete if you wish.<br />
<br />
'''Q: Mahara is complaining about collation or UTF8 in MySQL'''<br />
<br />
'''A:''' This [http://mahara.org/interaction/forum/topic.php?id=3285 forum post] might be helpful.<br />
<br />
1) Make a backup of the database using mysqldump<br />
<br />
2) Add the following lines to the beginning of the mysql dump file:<br />
<br />
drop database mahara_dev;<br />
create database mahara_dev character set UTF8;<br />
use mahara_dev;<br />
<br />
&lt;br /&gt; 3) mysql -h -u -pxxxxxx &amp;lt; your_dump.sql<br />
<br />
4) Refresh browser<br />
<br />
'''Q: I'm still having trouble, how can I get more help?'''<br />
<br />
'''A:''' Two options available to you are:<br />
<br />
* [http://mahara.org/interaction/forum/?group=1 The forums], here on mahara.org<br />
* The #mahara IRC channel on irc.freenode.org</div>WikiSysophttps://wiki.mahara.org/index.php?title=System_Administrator%27s_Guide/Installing_Mahara/Mahara_on_fastcgi//nginx&diff=1186System Administrator's Guide/Installing Mahara/Mahara on fastcgi//nginx2011-05-12T05:47:02Z<p>WikiSysop: </p>
<hr />
<div>Mahara does not require the fairly bloated apache/mod_php environment. It runs fine in fastcgi environments and therefore with all other webservers supporting fastcgi, e.g. lighttpd and nginx.<br />
<br />
Please note however that this is '''not''' officially supported by the Mahara team, although we will try to fix bugs found and we will accept patches. If you encounter bugs in Mahara, make sure you point out you're running Mahara using fastcgi/nginx!<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
===Setup Instructions===<br />
<br />
It's not too hard to set up. You need to install and configure nginx, set up fastcgi, and configure php.ini somewhat.<br />
<br />
Here is a simple, tested nginx config that works with Mahara on an Ubuntu Lucid host:<br />
<br />
server {<br />
listen 80 default;<br />
server_name example.com;<br />
root /var/www/example.com;<br />
index index.php;<br />
server_tokens off;<br />
<br />
access_log /var/log/nginx/example.com.access.log;<br />
<br />
location / {<br />
try_files $uri $uri/;<br />
expires 3d;<br />
<br />
gzip on;<br />
gzip_disable &quot;MSIE [1-6]\.(?!.*SV1)&quot;;<br />
gzip_types text/css application/x-javascript;<br />
}<br />
<br />
location ~ \.php$ {<br />
include fastcgi_params;<br />
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;<br />
fastcgi_intercept_errors on;<br />
fastcgi_pass 127.0.0.1:9000;<br />
}<br />
<br />
location ~ /\.ht {<br />
deny all;<br />
}<br />
}<br />
<br />
server {<br />
server_name www.example.com;<br />
rewrite ^ $scheme://example.com$request_uri? permanent;<br />
}<br />
<br />
<br />
Note the following points:<br />
<br />
* This configuration avoids many common Mahara and nginx configuration pitfalls. The location regex match for .php files applies first as it is most specific, and passes all PHP scripts through to a fastcgi server running at 127.0.0.1:9000. Naturally, this means you need fastcgi running there - this nginx config alone isn't enough to run Mahara, you should read below for more info about this.<br />
* The config blocks requests to .htaccess and friends, which nginx doesn't consider special. You'll do your PHP configuration entirely in php.ini and friends as part of the fastcgi server setup.<br />
* The location / block is the last block handled. try_files means that nginx tries to serve the file statically. If found, the files are served with an expires header of 3 days, gzipped in browsers that support it. Note that Mahara doesn't manage static file versioning at all, so you may want to reduce the expires time.<br />
* There are two server blocks, the second one is to redirect www.example.com to example.com. Doing it with two blocks is nice and clear, and works correctly with Mahara so you don't mess up Mahoodle integration.<br />
<br />
Along with the nginx configuration, you need PHP running as fastcgi. Thankfully, this is quite easy - PHP ships with a cgi binary that can run in fastcgi mode. Under ubuntu, install the &lt;code&gt;php5-cgi&lt;/code&gt; package to get it. Then, put the following into &lt;code&gt;/etc/init.d/php&lt;/code&gt; or similar:<br />
<br />
&lt;nowiki&gt;#! /bin/sh<br />
<br />
### BEGIN INIT INFO<br />
# Provides: php<br />
# Required-Start: $local_fs $remote_fs $network $syslog<br />
# Required-Stop: $local_fs $remote_fs $network $syslog<br />
# Default-Start: 2 3 4 5<br />
# Default-Stop: 0 1 6<br />
# Short-Description: starts the php fastcgi server<br />
# Description: starts php using start-stop-daemon<br />
### END INIT INFO<br />
<br />
BIND=127.0.0.1:9000<br />
USER=www-data<br />
PHP_FCGI_CHILDREN=5<br />
PHP_FCGI_MAX_REQUESTS=1000<br />
<br />
PHP_CGI=/usr/bin/php-cgi<br />
PHP_CGI_NAME=`basename $PHP_CGI`<br />
PHP_CGI_ARGS=&quot;- USER=$USER PATH=/usr/bin PHP_FCGI_CHILDREN=$PHP_FCGI_CHILDREN PHP_FCGI_MAX_REQUESTS=$PHP_FCGI_MAX_REQUESTS $PHP_CGI -b $BIND&quot;<br />
RETVAL=0<br />
<br />
start() {<br />
echo -n &quot;Starting PHP FastCGI: &quot;<br />
start-stop-daemon --quiet --start --background --chuid &quot;$USER&quot; --exec /usr/bin/env -- $PHP_CGI_ARGS<br />
RETVAL=$?<br />
echo &quot;$PHP_CGI_NAME.&quot;<br />
}<br />
stop() {<br />
echo -n &quot;Stopping PHP FastCGI: &quot;<br />
killall -q -w -u $USER $PHP_CGI<br />
RETVAL=$?<br />
echo &quot;$PHP_CGI_NAME.&quot;<br />
}<br />
<br />
case &quot;$1&quot; in<br />
start)<br />
start<br />
;;<br />
stop)<br />
stop<br />
;;<br />
restart)<br />
stop<br />
start<br />
;;<br />
*)<br />
echo &quot;Usage: php-fastcgi {start|stop|restart}&quot;<br />
exit 1<br />
;;<br />
esac<br />
exit $RETVAL<br />
&lt;/nowiki&gt;<br />
<br />
&lt;div&gt; &lt;/div&gt;<br />
<br />
Note some points about this file:<br />
<br />
* You'll need to chmod +x it, and you probably want to rig it up to start on boot. (fixme: someone put instructions here for doing that)<br />
* You seriously don't need as many children as you think. Nginx will handle all of the static files, so you only need enough to handle all the concurrent PHP requests you think you'll get. If you run PHP with eaccelerator or similar, you should be able to push through most pages in 250 milliseconds or less, meaning one child can handle four requests per second. Running too many children will actually cause more pain than it's worth, as the children will contend for CPU and hold RAM without actually speeding things up. If you have a single-CPU machine, it actually makes sense to just have one child. YMMV - benchmark on your hardware to work out the minimum number of children that get the best result for you.<br />
<br />
Finally - remember to configure your php.ini. Check Mahara's .htaccess and configure the php.ini the way the .htaccess does. Also make sure you set &lt;code&gt;cgi.fix_pathinfo&lt;/code&gt; to 0, else you'll potentially be vulnerable to arbitrary code injection attacks (Mahara should already protect you against these, but &lt;code&gt;cgi.fix_pathinfo&lt;/code&gt; is unnecessary at best, and dangerous at worse).<br />
<br />
With the above setup on a VPS with 600MB of RAM, Mahara can push through 20 reqests per second. That's 20 PHP pages, so well more than 20 concurrent users, and that's just on a VPS. Dedicated hardware should easily handle far higher loads.<br />
<br />
&lt;/div&gt;&lt;div id=&quot;section_2&quot;&gt;<br />
<br />
===SSL===<br />
<br />
This example demonstrates a setup using both plain http as well as ssl in multiple domains. At the time of writing, mahara (1.13) works nicely with this kind of setup. Multi-Domain setups will however break the communication toward moodle.<br />
<br />
&lt;code&gt;server {&lt;br /&gt; listen 443;&lt;br /&gt; listen 80;&lt;br /&gt;&lt;br /&gt; server_name www.example.de, www.example.net, www.example.org ;&lt;br /&gt; optimize_server_names on;&lt;/code&gt;<br />
<br />
&lt;code&gt; # Note: single domain setups obviously need only one listen directive&lt;br /&gt; # and one single domain declaration in server_name&lt;br /&gt;&lt;/code&gt;<br />
<br />
&lt;code&gt; # ssl setup&lt;br /&gt; ssl on;&lt;br /&gt; ssl_certificate /etc/nginx/example.crt;&lt;br /&gt; ssl_certificate_key /etc/nginx/example.key;&lt;br /&gt; add_header Front-End-Https on;&lt;/code&gt;<br />
<br />
&lt;code&gt; # logging&lt;br /&gt; access_log /var/log/nginx/example/access.log;&lt;br /&gt; error_log /var/log/nginx/example/error.log;&lt;/code&gt;<br />
<br />
&lt;code&gt; # enable for debugging purpose&lt;br /&gt; # error_log /var/log/nginx/example/error.log debug;&lt;br /&gt;&lt;br /&gt; location / {&lt;br /&gt; root /var/www/example;&lt;br /&gt; index index.html index.php;&lt;br /&gt; }&lt;br /&gt;&lt;br /&gt; location ~ .php {&lt;br /&gt; include /etc/nginx/fastcgi_params;&lt;br /&gt; fastcgi_param HTTPS on;&lt;br /&gt; fastcgi_param SCRIPT_FILENAME /var/www/example$fastcgi_script_name;&lt;br /&gt; fastcgi_param QUERY_STRING $query_string;&lt;br /&gt; if (-f $request_filename) {&lt;br /&gt; break;&lt;br /&gt; }&lt;br /&gt; fastcgi_pass 127.0.0.1:9999;&lt;br /&gt; }&lt;/code&gt;<br />
<br />
&lt;nowiki&gt;#&lt;/nowiki&gt;&lt;br /&gt; # these declarations are taken from a similar setup for CMSIMPLE and have yet to be adopted &lt;br /&gt; # mahara, which should be straightforward. Highly recommended for production sites.&lt;br /&gt; #<br />
<br />
&lt;nowiki&gt;#&lt;/nowiki&gt;&lt;br /&gt; # security: deny access to all places which only the mahara scripts may see<br />
<br />
&lt;code&gt;&lt;nowiki&gt;# location ~ /(classes|functions|misc|modules|includes|db|locale|lib)/ {&lt;/nowiki&gt;&lt;br /&gt; # deny all;&lt;br /&gt; # }&lt;br /&gt;&lt;br /&gt; # &lt;br /&gt; # serve static files directly&lt;br /&gt;&lt;br /&gt; # location ^/.*+.(jpg|jpeg|gif|css|png|js|ico|htm|html)$ {&lt;br /&gt; # root /var/www/example;&lt;br /&gt; # access_log off;&lt;br /&gt; # expires 30d;&lt;br /&gt; # }&lt;br /&gt;&lt;br /&gt; }&lt;br /&gt; }&lt;/code&gt;<br />
<br />
&lt;br /&gt; In addition, the following settings have to be present /etc/nginx/fastcgi_params&lt;code&gt;&lt;br /&gt;&lt;/code&gt;<br />
<br />
&lt;code&gt;&lt;br /&gt; fastcgi_param QUERY_STRING $query_string;&lt;br /&gt; fastcgi_param REQUEST_METHOD $request_method;&lt;br /&gt; fastcgi_param CONTENT_TYPE $content_type;&lt;br /&gt; fastcgi_param CONTENT_LENGTH $content_length;&lt;br /&gt;&lt;br /&gt; fastcgi_param SCRIPT_NAME $fastcgi_script_name;&lt;br /&gt; fastcgi_param REQUEST_URI $request_uri;&lt;br /&gt; fastcgi_param DOCUMENT_URI $document_uri;&lt;br /&gt; fastcgi_param DOCUMENT_ROOT $document_root;&lt;br /&gt; fastcgi_param SERVER_PROTOCOL $server_protocol;&lt;br /&gt;&lt;br /&gt; fastcgi_param GATEWAY_INTERFACE CGI/1.1;&lt;br /&gt; fastcgi_param SERVER_SOFTWARE nginx;&lt;br /&gt;&lt;br /&gt; fastcgi_param REMOTE_ADDR $remote_addr;&lt;br /&gt; fastcgi_param REMOTE_PORT $remote_port;&lt;br /&gt; fastcgi_param SERVER_ADDR $server_addr;&lt;br /&gt; fastcgi_param SERVER_PORT $server_port;&lt;br /&gt; fastcgi_param SERVER_NAME $server_name;&lt;br /&gt;&lt;br /&gt; # PHP only, required if PHP was built with --enable-force-cgi-redirect&lt;br /&gt; fastcgi_param REDIRECT_STATUS 200;&lt;br /&gt;&lt;br /&gt; ## bea ++&lt;br /&gt; fastcgi_pass_header Authorization;&lt;br /&gt; fastcgi_intercept_errors off;&lt;/code&gt;&lt;br /&gt;<br />
<br />
And finally the code snippet required in Mahara's config.php to enable multiple domains if desired:<br />
<br />
&lt;font face=&quot;courier new,courier&quot;&gt;$cfg-&amp;gt;wwwroot = 'http'&lt;br /&gt;&lt;nowiki&gt; . (isset($_SERVER['HTTPS']) ? $_SERVER['HTTPS'] == 'on' ? 's' : '' : '');&lt;/nowiki&gt;&lt;br /&gt; $cfg-&amp;gt;wwwroot .= '://' .$_SERVER['HTTP_HOST'] .'/';&lt;/font&gt;<br />
<br />
&lt;/div&gt;</div>WikiSysophttps://wiki.mahara.org/index.php?title=System_Administrator%27s_Guide/Installing_Mahara/Installing_Mahara_in_Wampserver&diff=1185System Administrator's Guide/Installing Mahara/Installing Mahara in Wampserver2011-05-12T05:46:51Z<p>WikiSysop: </p>
<hr />
<div>If you need to set up a Mahara development site, and you don´t have prior knowledge of Debian-Ubuntu, you can install Mahara under WAMPSERVER. This last one is a web development environment which allows to run web applications using Apache, MySQL and php in a windows environment. It also includes phpmyAdmin and SQLiteManager to manage the databases.<br />
<br />
The following steps have been only tested with Wampserver 2.0c, so if you have already a previous version installed and doesn’t work, you may need to upgrade to 2.0c.<br />
<br />
If you are using a newer version, such as Wampserver 2.0h, you may find useful the troubleshooting section, at the end of this page.<br />
<br />
'''1.''' The first step is to download and install the latest version of WAMPSERVER. This installation is pretty straightforward and you shouldn’t have any problems with it. Once it is installed, click on the shortcut Wampserver icon displayed on screen. You will notice a new small icon display on the bottom left of the taskbar. You can activate the different utilities of WAMPSERVER by clicking on that small icon.<br />
<br />
'''2.''' Download the latest stable version of Mahara (we'll assume you've downloaded the .zip file).<br />
<br />
'''3.''' Extract the contents of the Mahara zip file in a temporary directory. Rename the htdocs subdirectory to 'mahara' (without the quotes) and then move that subdirectory inside the /www directory that Wampserver has created in your hard-drive (we'll assume it's C:\wamp\www). Also create the data directory for Mahara inside the Wampserver installation directory (we'll assume it's C:\wamp\data).<br />
<br />
'''4.''' The next step is to configure all the variables in the config-dist.php file. You need to complete this file with the values of your installation:<br />
<br />
&lt;font size=&quot;smaller&quot;&gt;$cfg-&amp;gt;dbtype = 'mysql5'; &lt;br /&gt;$cfg-&amp;gt;dbhost = 'localhost';&lt;br /&gt;$cfg-&amp;gt;dbport = null;&lt;br /&gt;$cfg-&amp;gt;dbname = 'mahara'; // this is the name of the mahara database&lt;br /&gt;$cfg-&amp;gt;dbuser = 'root'; // this is usually the default user for the database administrator.&lt;br /&gt;&lt;nowiki&gt;$cfg-&amp;gt;dbpass = ''; If you have added a password to your root user, you should add the password here.&lt;/nowiki&gt;&lt;br /&gt;&lt;nowiki&gt;$cfg-&amp;gt;dbprefix = '';&lt;/nowiki&gt;&lt;/font&gt;<br />
<br />
<br />
You need to configure the paths for the wwwroot and dataroot directories with the values in your installation. In my case: $cfg-&amp;gt;wwwroot = '[http://localhost/mahara/ http://localhost/mahara/']; and $cfg-&amp;gt;dataroot = 'C:\\wamp\\data'; (the double slashes '''are important''').<br />
<br />
Leave the rest of the config-dist file as it is. Once you have saved the file, rename it as “config.php”<br />
<br />
'''5.''' Before launching Mahara, we need to create the database, with the same name that we have set up in the config.php file. For that, go to the “phpmyAdmin” menu of “Wampserver”. Type “mahara” -or the name you have added for your database in the config file- in the box “create new database”, select “utf8_unicode_ci” in the drop down select box and click on the “Create” button.<br />
<br />
'''6.''' Once the database has been created, go to the “localhost” option of Wampserver. You will see that under “Project” (it's called “Your Projects” under Wampserver 2.0h and above), there is a new folder called “mahara”. Click on it in order to complete the installation.<br />
<br />
If everything goes OK, Mahara will start installing the different pluggins and components in the database.<br />
<br />
When the installation finishes, if everything goes OK, you will be prompted to log in first time in Mahara as administrator (remember that the username is “admin” and the password “mahara”).<br />
<br />
&lt;div id=&quot;section_1&quot;&gt;<br />
<br />
=Troubleshooting=<br />
<br />
'''Q: I got an error message saying that &quot;the curl extension is not included&quot;. How can I enable it? '''<br />
<br />
'''A:''' You can enable additional extensions in the file php.ini. The easiest way to do so is by clicking on the Wampserver icon, going to the php folder visible icon and clicking on the the php.ini file. Then, you need to uncomment the line &quot;extension=php_curl line&quot; and save the file. Next click on the Wampserver icon and select “Restart all services”. Then go back to your browser window and click on the “refresh” button to restart the Mahara installation.<br />
<br />
'''Q: I got an error message saying that &quot;Your server does not have the mime_magic extension enabled. Mahara may have trouble detecting file types&quot;. How can I fix this? '''<br />
<br />
'''A:''' You need to use the Fileinfo extension (as the original Mime Magic extension has been deprecated).<br />
<br />
'''Q: I have followed all the aforementioned steps, but Mahara gets stuck when installing the first component (core code).&lt;br /&gt;'''<br />
<br />
'''A:''' Are you using Wampserver 2.0h?... Although we cannot guarantee that the following instructions are going to solve your problem, try this:<br />
<br />
# In the php.ini, increase the values of the following variables:<br />
<br />
max_execution_time = 120<br />
<br />
memory_limit = 256M.<br />
<br />
(just restart all wampserver services after that)<br />
<br />
2. Open the file hdocts/lib/db/install.xml and replace the code for view_layout table with this one:<br />
<br />
&lt;font face=&quot;courier new,courier&quot;&gt;&lt;font size=&quot;1&quot;&gt;&lt;/font&gt;&lt;/font&gt;<br />
<br />
{|<br />
|<br />
&lt;br /&gt; &lt;br /&gt; &lt;br /&gt; &lt;font size=&quot;1&quot; color=&quot;#ff0000&quot;&gt;1columns&lt;/font&gt;&lt;font size=&quot;1&quot;&gt;&quot; TYPE=&quot;int&quot; LENGTH=&quot;1&quot; NOTNULL=&quot;true&quot;/&amp;gt;&lt;br /&gt; &lt;br /&gt; &lt;/font&gt;&lt;br /&gt; &lt;br /&gt; &lt;br /&gt; &lt;font size=&quot;1&quot; color=&quot;#ff0000&quot;&gt;1columns&lt;/font&gt;&lt;font size=&quot;1&quot;&gt;,widths&quot;/&amp;gt;&lt;br /&gt; &lt;/font&gt;&lt;br /&gt;<br />
|}<br />
<br />
where the original field &quot;columns&quot; have been now replaced by &quot;&lt;font color=&quot;rgb(255, 0, 0)&quot;&gt;1columns&lt;/font&gt;&quot; (you will be able to rename again this field once the Mahara database has been created).<br />
<br />
3. If there is an incomplete Mahara database already created by the installer, just delete it and start the installation again, by going to the step 6 of the previous section.<br />
<br />
As I mentioned before, we cannot guarantee that this is going to solve your problem. Mahara was developped to run on linux/unix distributions from the very beginning, and we are trying different &quot;patches&quot; to make it work with windows.<br />
<br />
If this does not solve your problem, you can ask for additional help at Mahara Community.<br />
<br />
&lt;/div&gt;</div>WikiSysophttps://wiki.mahara.org/index.php?title=System_Administrator%27s_Guide/Installing_Mahara/How_to_install_Mahara_in_Ubuntu&diff=1184System Administrator's Guide/Installing Mahara/How to install Mahara in Ubuntu2011-05-12T05:46:47Z<p>WikiSysop: </p>
<hr />
<div>If you are unfamiliar with Linux in general, and Debian-based distributions in particular, this guide will show you how to proceed, in addition to the &quot;Installing Mahara&quot; document.<br />
<br />
This guide is just for installing a development site of Mahara as a localhost. For a production site, you would read the complete &quot;[https://help.ubuntu.com/8.04/serverguide/C/index.html Ubuntu Server Guide]&quot; documentation.<br />
<br />
During the installation process of Ubuntu 9.04, you should have had the option of installing a lamp server for local web development, but if not, the instructions are pretty simple. From the console, just type:<br />
<br />
sudo apt-get install apache2 php5 mysql-server-5.0 phpmyadmin<br />
<br />
<br />
Hopefully, this will install all the dependencies we need. Phpmyadmin is not strictly needed to run your Mahara development site, but will allow you to check the database structure of Mahara. you can launch phpmyadmin by typing in your browser: localhost/phpmyadmin.<br />
<br />
After we are sure that we have a lamp server platform installed, just follow the instructions provided in the &quot;[[System Administrator's Guide/Installing Mahara|Installing Mahara]]&quot; main document to unzip and install the Mahara folders. As we are using MySQL as database, you can create the Mahara database directly in phpmyadmin. Remember to choose &quot;utf8_general_ci&quot; as a codification standard.<br />
<br />
The next step is to add your Mahara site as a new virtual hosts. There are many ways of doing so. This way will allow you to practice some Ubuntu commands (but if you are really desperate for time, there is a fastest way at the end of the explanation):<br />
<br />
# Create a new file called &quot;mahara.conf&quot; (for instance) at /etc/apache2/sites-available.<br />
# You need to edit that file by typing from the console:<br />
<br />
sudo gedit /etc/apache2/sites-available/mahara.conf<br />
<br />
(or alternatively &quot;sudo nano /etc/apache2/sites-available&quot;).<br />
<br />
3.It is in this file where we are going to copy and paste the &quot;Virtual Host&quot; bit in the main instructions that you don't know what to do with. You need to customize that file with the values for your installation, in my case:<br />
<br />
&lt;br /&gt; ServerName mahara.es &lt;br /&gt; DocumentRoot /home/mcgarcia/mahara&lt;br /&gt;&lt;br /&gt; ErrorLog /var/log/apache2/mahara-1-2-alpha.error.log&lt;br /&gt; CustomLog /var/log/apache2/mahara-1-2-alpha.access.log combined&lt;br /&gt;<br />
<br />
One we have added a this new virtual host, we need to link it with the ''repertoir'' of virtualhost that Apache looks, which is in the folder &quot;sites-enabled&quot;. So we go to that folder and create the link to the new host:<br />
<br />
$cd /etc/apache2/sites-enabled/<br />
<br />
$sudo ln -s /etc/apache2/sites-available/mahara.conf mahara conf<br />
<br />
And here comes the fastest way of enabling a new virtual host, just typing:<br />
<br />
sudo a2ensite mahara.conf<br />
<br />
<br />
4. You need to add the domain that you have choosen for your servername as a localhost domain, by editing the /etc/hosts file:<br />
<br />
sudo gedit /etc/hosts<br />
<br />
In that file, make sure that you got the line:<br />
<br />
127.0.0.1 localhost yourmaharadomain (in my case: mahara.es)<br />
<br />
which, hopefully, will tell Ubuntu: don't go online everytime that I type that domain in my browser, as it corresponds to a localhost address).<br />
<br />
5. Then, restart (or reload) Apache:<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
The next step is to create the config.php from the config-dist.php. This step is pretty well explain at the &quot;[[System Administrator's Guide/Installing Mahara|Mahara Configuration]]&quot; secction of the installation guide, so we are not going to repeat it here. If it is of any help, here is how I configured my paths to the wwwroot and the dataroot:<br />
<br />
$cfg-&amp;gt;wwwroot = 'http://mahara.es/';<br />
<br />
$cfg-&amp;gt;dataroot = '/home/mcgarcia/maharadata';<br />
<br />
Even for a development site, you need to make sure that the dataroot folder-maharadata-is writable for webserver user. If not, Mahara will tell you.<br />
<br />
There is a very good-and short-[http://catcode.com/teachmod/ tutorial ] about how to change permissions and groups of users in Ubuntu by using the chmod command. It only takes 10 minutes to read it and it really gives you a good insight.<br />
<br />
Once the dataroot folder permissions have been set up correctly, we are going to launch the installer by going to the web browser and typing the url of virtual host.<br />
<br />
It looks like... it is working? Then, Mahara tells you that you need to install some php extensions. In may case, they were the gd and curl extensions, so I typed from console:<br />
<br />
sudo apt-get install php5-gd<br />
<br />
sudo apt-get install php5-curl<br />
<br />
and don't forget to reload apache after that.<br />
<br />
Once all the required extensions have been installed, Mahara will start installing the core components.</div>WikiSysop