History: Contribution

            ! Contribution (types)
Contribution (types) adds an additional drop-down field to the add/edit/modify screen of wikipages, blogs, comments, tikisheets, and forums. The administrator configures this feature so that the drop down contains a list of "contribution types" (or other required information) and can make using this selector required to make a save. Thus it can function as a mandatory Edit Comment field.

Once entered, contribution types are color coded, and can be viewed in summary graphs, the ((action log)) and in the revision history.

{REMARKSBOX(type="note", title="Features 'Contribution (types)' vs. 'Contributions by Author'")}
Keep in mind that this feature can be used in parallel to the __((Contributions by Author))__, since they both cover fetching data from the authors contributions:
* __((Contributions by Author))__ works on a page per page basis, showing which piece of text was written by whom, for any page version that you are viewing.
* __((Contribution))__ allows each user to indicate the type of contribution performed in each wiki page, comments, sheets, blogs, .... And by means of the __((Action log))__ feature, an editor can see a report on a collection of pages (which can be filtered/grouped by categories, selection of multiple users, groups of users, and time periods), showing not only the amount of text added or deleted for each user or group of users, but also the types of contributions, as tagged by users (students) and corrected (if needed) by editors (teachers)
{REMARKSBOX}


!! Enabling the feature
Activate this ((feature)) from the ((Features Admin)) page (Admin -> Features -> Global Features -> Contribution) at yourURL/tiki-admin.php?page=features

Scope: this feature affects ((Blog)), ((Wiki)), ((Comments)), ((Spreadsheet)), or ((forums)).

Related features:
Edit Comment (which it compliments in wiki), ((Wiki Page Staging and Approval)) (an approval mechanism), and ((MyAccount)) (tracking user contributions and todos). ((Contributions by Author))

!! Usage
Initially designed for educational scenarios, promoting and enhancing students  onto experiential-reflective learning (See below, at {ALINK(aname=>refbox)}references section{ALINK}).

May also be useful for workgroups and ((project management)).

!! Details
For instance, a contribution can be:
* support requests
* questions that allow new evolution on an electronic discussion/dialogue
* new hypothesis
* new information
* summarizing
* issues related to organization in the team of work
* ...

{SHEET(id=>1)}Example of table of contribution types, used for production on some degrees at University of Barcelona, Spain. See {ALINK(aname=>refbox)}De Pedro, 2007{ALINK}, for more details{SHEET}

!! Examples
!!! Forum
Example on forum post, prior to posting:

^::{img src="img/wiki_up/Contribution_Forum_edit.png" width=600 }::^

and after posting:

^::{img src="img/wiki_up/Contribution_forum_post_.png" width=600 }::^


The byte count in action log report does not take into account the lines starting by "> " or included by QUOTE tags (previous message).

!!! Wiki
Example at wiki edition time, showing the description of each item in the list of type of contributions as a pop up blue window when the mouse passes over the help roud blue icon ({img src=img/icons/help.png}).

^::{img src="img/wiki_up/contribution_wiki_edit_ca.jpg"  width=600 } ::^

Example on Wiki page history:

^::{img src="img/wiki_up/Contribution_Wiki_history_.png" width=600 }::^

!!! Tikisheet
Example on a spreadsheet:

^::{img src="img/wiki_up/contribution_sheet_edit_ca.jpg" }::^

!! Report contributions in tables
The ((Action log|action log)) feature can display them.

^::{img src="img/wiki_up/Contribution_action_log_.png" width=600 }::^

There is also a table reporting the evolution in time (weeks or days) of contributions:

^::{img src="img/wiki_up/actionlog_user_report_contrib_01.png" }::^

~~green:Additions are shown in green~~ background, ~~red:deletions in pink~~, and the difference is shown without any special background color. Units are either bytes or kb, specified previously through the reporting filters described in ((Action log)) page, as well as start and end date, and if columns are days or weeks.

The main goal of reporting them is showing students in tutorship sessions what the log of their activity respect to the average of their class, for instance, as a simple way to enable students self-regulate their effort investment in the learning process of that activity/subject/course, etc. Many other uses can be achieved with that information, and it is not intended to be the only way to "grade" students activity but to enhance broad information to tutors about students activity to improve feedback to student along the learning activity process, and not only as grading information at the end. 

!! Reporting contributions in graphs
When contribution feature is enabled, ((Action log)) feature will allow displaying the summaries of contribution by types along time also in graphs. The graphs are produced in better quality when __jpgraph__ library is installed in you Tiki (see ((Mod jpgraph)) for more details). You can also download the library in lib/jpgraph.
Nota: the preference feature_jpgraph must be manually turn in in the database adn you must clear the cache after.
{CODE()}
insert into tiki_preferences (name, value)values('feature_jpgraph', 'y');
{CODE}


These are the type of graphs produced (examples produced having jpgraph lib installed on the site)

!!! Users contribution: Addition and Suppression
^::{img src="img/wiki_up/actionlog_graph_report_01_.png" }::^

^::{img src="img/wiki_up/actionlog_graph_report_02_.png" }::^

!!! Total contributions: Additions and Suppressions over time
^::{img src="img/wiki_up/actionlog_graph_report_03ab_.png" }::^

!!! Total contributions: Additions and Suppressions
^::{img src="img/wiki_up/actionlog_graph_report_04ab_.png" }::^

!!! Group contributions: Additions and Suppressions
^::{img src="img/wiki_up/actionlog_graph_report_05ab_.png" }::^

!! Contributor feature
This feature can be enabled in Admin -> Contribution. It allows an user to select which other mats of his/her group where co-authoring (or just contributing, at least) to that wiki page edition.

^::{img src="img/wiki_up/enable_contributor.jpg" }::^


^::{img src="img/wiki_up/contributors_wiki_edit_01.jpg" }::^

Action log will reflect that contribution also.

Note that there is a setting to allow users to see user's contributions (within a user activity log) at Admin -> Login (__"Displays user's contribution in the user information page:"__). If enabled, a user will be able to see other user's activity log, including his/her contributions on the report.
 
---

{ANAME()}refbox{ANAME}{BOX(title=>References)}
;Kolb. D. A. and Fry, R. (1975): Toward an applied theory of experiential learning. in C. Cooper (ed.) Theories of Group Process, London: John Wiley.
;De Pedro, X. (2006): "Estimulación y evaluación del aprendizaje 'experiencial-reflexivo' del alumnado mediante la formulación explícita del tipo de contribuciones". Workgroup on Experiential-Reflective Learning, at the Institute of Sciences of Education, University of Barcelona, Catalonia, Spain. 100 pp. (pdf: [http://seeds4c.org/dl529])
;De Pedro, X. (2007): "New method using Wikis and forums to evaluate individual contributions in cooperative work while promoting experiential learning: results from preliminary experience". Communication Submitted to  to [http://www.opensym.org/ws2007|__WikiSym2007__] ([http://www.opensym.org/ws2007]): ''2007 International Symposium on Wikis. Wikis at Work in the World: Open, Organic, Participatory Media for the 21st Century. October 21-23, 2007, Montréal, Canada''. (Pdf: [http://seeds4c.org/dl539])
{BOX}

-=Related pages=-
* ((Contribution Admin))
* ((Contributions by Author))
* ((PluginContributionsDashboard))
* ((Action log))

-=External links=-
* [http://edu.tiki.org]

-=aliases=-
(alias(Contributions)) | (alias(ContributionTypes)) | (alias(Contribution Types))