Difference between revisions of "MePrints"

From EPrints Documentation
Jump to: navigation, search
(New page: We've used the following terms (note different use of "profile"): Profile - similar to abstract page - public-facing page providing (admin-customisable) information _about_ the user Home...)
 
 
(51 intermediate revisions by 4 users not shown)
Line 1: Line 1:
We've used the following terms (note different use of "profile"):
+
[[Category:MePrints]]
 +
All About MEPrints is a JISC rapid innovations project to build a user profile system for EPrints. The aim is that every repository user will have a page which promotes their work and identity within the repository and beyond. It is hoped this will improve user-to-repository relations and also provide useful information for user-to-user interactions.
  
Profile - similar to abstract page - public-facing page providing (admin-customisable) information _about_ the user
+
The extension we have developed is called MePrints. This page gives an overview of the features of the MePrints extension.
  
Homepage - replaces the current EPrints "Profile" page - internal page providing (user-customisable) information _to_ the user
+
For technical instructions on how to install MePrints, see [[MePrintsInstall]].
  
This seems to be the Facebook convention.
+
=Introduction=
  
Overview of AllAboutMePrints features
+
MePrints is a plugin for EPrints 3.1+ that extends the user aspect of EPrints with user profiles and homepages. Profile pages are public-facing pages providing, admin-customisable, information ''about'' the user. Homepages replace the current EPrints "Profile" page and provide, admin and user-customisable, information from the repository so that the user can get a quick overview of anything that is relevant to them.
=====================================
 
  
(Note: please see also attached documents for further details)
+
The hope is that MePrints functionality will find it's way into the EPrints 3.2 trunk so that it is available to use with a new install of EPrints.
  
1) Additional user metadata
+
=Features=
  
A few extra useful defaults: expertise, qualifications, biography
+
MePrints brings a number of additional features to EPrints to improve your user experience with EPrints.
  
divisions - uses the same hierarchy as eprint.divisions (thinking is keep dept/org for external users but divisions for internal users)
+
==Profile Pages==
 +
[[Image:MePrints User Profile Thumb.png|frame|right|||An example MePrints User Profile||This image shows an example MePrints User Profile.]]
  
2) Public user search
+
Public user profile pages provide a static view of data that describes you as a repository user. The information that is displayed on these pages is configurable by the repository administrator. If you do not want your profile page to be accessible to the outside world then you can set your profile to be hidden so that it is not visible to anyone. Profiles also have a search engine friendly URL assigned to them as well in the form <nowiki>http://repository.org/profile/username</nowiki>. This allows you to easily share their EPrints profile with other people.
  
New cgi/search_users added with corresponding Screen::Public::UserSearch
+
Profile pages include the following information;
 +
* Name
 +
* Expertise
 +
* Qualifications
 +
* Divisions
 +
* Biography
 +
* User Image
  
http://allaboutme.eprints.org/cgi/search_users/user_public
+
<div style="clear: both;"></div>
  
3) Public user browse
+
==Homepages==
 +
[[Image:MePrints Homepage Thumb.png|frame|right|||An example MePrints User Homepage||This image shows a screenshot of an example MePrints User Homepage.]]
  
Update::Views modified so that you can specify the dataset in views.pl (assumes eprint dataset if none specified)
+
This replaces the initial "Manage Deposits" view that you see when they first login. The "Manage Deposits" view is still available although it is now accessible through the link at the top of the page.  
  
http://allaboutme.eprints.org/view/user_expertise/
+
This page is highly customisable for both the repository administrator and you. A repository administrator can create [[#Widgets|widgets]], which are a special type of plugin that provide information from the repository that is relevant to you. Also the administrator can create different layouts for the homepage so that [[#Widgets|widgets]] on the page will be laid out in different ways. You can then choose the layout that you prefer from a number of available layouts if your repository administrator has made several available for use.
http://allaboutme.eprints.org/view/user_expertise/eprints.html
 
http://allaboutme.eprints.org/view/user_division/sch=5Fecs.html
 
  
4) Public user profile pages
+
You can further customise your homepage by changing the positions of the widgets and adding or removing [[#Widgets|widgets]] that the repository administrator has installed.
  
New bin/generate_userprofiles script, generate_static() added to DataObj::User.
+
<div style="clear: both;"></div>
  
Repository admin can define which content (see Widgets - below) is displayed on the profile page - same for all user for consistency.
+
==Widgets==
 +
Widgets appear both on your profile and your homepage. The widgets that appear on your profile are managed by the repository administrator while on your homepage you have a degree of control over what widgets appear, from the collection of available widgets, and where on the page they appear.
  
http://allaboutme.eprints.org/profile/mmr
+
Widgets available by default with MePrints include;
http://allaboutme.eprints.org/profile/seb
+
* User Details - Shows the username, biography, expertise and other core data fields.
 +
* User Picture - Allows the user to upload an image of themselves for their profile.
 +
* User Actions - Adds a box containing all of the possible user actions.
 +
* Recently Published Items - Shows items that the user has recently published in the repository.
 +
* Item Issues - Shows any issues with items, owned by the user, that have been discovered by an issues audit.
 +
* Quick Upload -  Allows the user to upload a file and attach it to a new record in their inbox, ready for publication on the repository later.
 +
* Most Popular Items - Looks at the number of times a users items have been accessed and displays a rundown of the most popular.
 +
* IRStats Mini Dashboard - If the repository has IRStats installed this widget can display data from it and allow the user to look at a number of different statistics regarding their publications.
  
Note change to Apache::Rewrite to allow nice profile URLs
+
This list may differ for you if your repository administrator has disabled or added any widgets.
  
5) Internal user homepage
+
==Searching For Users==
 +
MePrints makes it possible for you to search through all of the users who have made their profiles public. If you make your profile private and don't allow anyone to see it then it will not be included in any search results as well as not allowing anyone to view it.
  
Replaces Screen::User::View.
+
===Browsing For Users By Expertise===
 +
A new browse view has been added with MePrints that allows you to browse for users by expertise.
  
This screen lays out a number of content "widgets" (currently simple 2 column layout).
+
===User Search Page===
 +
There is a new user search provided by MePrints, cgi/search_users, which allows you to search through users in the EPrints repository.
  
Users will see a list of available widgets and add them to their homepage (like items_fields and review_fields, there will be a user metadata field for storing the user's layout preferences). Users will also be able to move the widgets around on the screen and remove widgets.
+
=Installation=
 +
MePrints can be installed on EPrints 3.3 from the Bazaar with a one-click install.
  
6) Profile content "widgets"
+
For older versions of MePrints/EPrints see: Installation of MePrints on an existing EPrints 3.1 repository has been designed to be a simple as possible. Full instructions for installation can be found at [[MePrintsInstall]].
  
Stored in EPrints/Plugin/Widget/
+
[http://creativecommons.org/licenses/by/3.0/ This work is licensed under a Creative Commons Attribution 3.0 Unported License].
  
Currently widgets just have a render_content method and get rendered using a Box-like surround.
+
=Changelog=
  
Current widgets include:
+
==v1.4.3==
  
* User details **
+
Released on 16th September 2013 by sf2
* Available user actions **
 
* User picture
 
* Latest Items in archive
 
* Issues with items owned by this user
 
* Quick Upload (creates new record in inbox)
 
* Most popular items (queries access dataset)
 
  
Planned widgets include:
+
* Added missing user citation "details"
 
+
* Added new user citation "profile" to control the look and feel of the (external) profile page
* Latest comments (SNEEP integration)
+
* Removed calls to deprecated functions (EPrints 3.3+)
* IRStats mini-dashboard
+
* Added missing timestamp file to allow regeneration of profile pages from the Admin UI
* Latest activity eg. recently edited items, rejected items
+
* Added missing Admin screen plug-in to allow regen. of profile pages
* .. suggestions?
+
* Disabled user searches and user browse views by default
 
+
* Fixed the user setting their profile visibility to "public" / "private" and is now working
** these 2 widgets constitute the minimal information display of the current EPrints. We plan that these will always appear in a fixed position (alongside the user photo) on the Homepage and not be removable.
+
* Added missing CGI script "save" to save the position of the homepage's widgets
 +
* Added possibility to define locally-defined sizes of the profile pictures
 +
* Added missing triggers to allow regen of the profile pages when the user's metadata has changed

Latest revision as of 13:05, 12 March 2014

All About MEPrints is a JISC rapid innovations project to build a user profile system for EPrints. The aim is that every repository user will have a page which promotes their work and identity within the repository and beyond. It is hoped this will improve user-to-repository relations and also provide useful information for user-to-user interactions.

The extension we have developed is called MePrints. This page gives an overview of the features of the MePrints extension.

For technical instructions on how to install MePrints, see MePrintsInstall.

Introduction

MePrints is a plugin for EPrints 3.1+ that extends the user aspect of EPrints with user profiles and homepages. Profile pages are public-facing pages providing, admin-customisable, information about the user. Homepages replace the current EPrints "Profile" page and provide, admin and user-customisable, information from the repository so that the user can get a quick overview of anything that is relevant to them.

The hope is that MePrints functionality will find it's way into the EPrints 3.2 trunk so that it is available to use with a new install of EPrints.

Features

MePrints brings a number of additional features to EPrints to improve your user experience with EPrints.

Profile Pages

This image shows an example MePrints User Profile.

Public user profile pages provide a static view of data that describes you as a repository user. The information that is displayed on these pages is configurable by the repository administrator. If you do not want your profile page to be accessible to the outside world then you can set your profile to be hidden so that it is not visible to anyone. Profiles also have a search engine friendly URL assigned to them as well in the form http://repository.org/profile/username. This allows you to easily share their EPrints profile with other people.

Profile pages include the following information;

  • Name
  • Expertise
  • Qualifications
  • Divisions
  • Biography
  • User Image

Homepages

This image shows a screenshot of an example MePrints User Homepage.

This replaces the initial "Manage Deposits" view that you see when they first login. The "Manage Deposits" view is still available although it is now accessible through the link at the top of the page.

This page is highly customisable for both the repository administrator and you. A repository administrator can create widgets, which are a special type of plugin that provide information from the repository that is relevant to you. Also the administrator can create different layouts for the homepage so that widgets on the page will be laid out in different ways. You can then choose the layout that you prefer from a number of available layouts if your repository administrator has made several available for use.

You can further customise your homepage by changing the positions of the widgets and adding or removing widgets that the repository administrator has installed.

Widgets

Widgets appear both on your profile and your homepage. The widgets that appear on your profile are managed by the repository administrator while on your homepage you have a degree of control over what widgets appear, from the collection of available widgets, and where on the page they appear.

Widgets available by default with MePrints include;

  • User Details - Shows the username, biography, expertise and other core data fields.
  • User Picture - Allows the user to upload an image of themselves for their profile.
  • User Actions - Adds a box containing all of the possible user actions.
  • Recently Published Items - Shows items that the user has recently published in the repository.
  • Item Issues - Shows any issues with items, owned by the user, that have been discovered by an issues audit.
  • Quick Upload - Allows the user to upload a file and attach it to a new record in their inbox, ready for publication on the repository later.
  • Most Popular Items - Looks at the number of times a users items have been accessed and displays a rundown of the most popular.
  • IRStats Mini Dashboard - If the repository has IRStats installed this widget can display data from it and allow the user to look at a number of different statistics regarding their publications.

This list may differ for you if your repository administrator has disabled or added any widgets.

Searching For Users

MePrints makes it possible for you to search through all of the users who have made their profiles public. If you make your profile private and don't allow anyone to see it then it will not be included in any search results as well as not allowing anyone to view it.

Browsing For Users By Expertise

A new browse view has been added with MePrints that allows you to browse for users by expertise.

User Search Page

There is a new user search provided by MePrints, cgi/search_users, which allows you to search through users in the EPrints repository.

Installation

MePrints can be installed on EPrints 3.3 from the Bazaar with a one-click install.

For older versions of MePrints/EPrints see: Installation of MePrints on an existing EPrints 3.1 repository has been designed to be a simple as possible. Full instructions for installation can be found at MePrintsInstall.

This work is licensed under a Creative Commons Attribution 3.0 Unported License.

Changelog

v1.4.3

Released on 16th September 2013 by sf2

  • Added missing user citation "details"
  • Added new user citation "profile" to control the look and feel of the (external) profile page
  • Removed calls to deprecated functions (EPrints 3.3+)
  • Added missing timestamp file to allow regeneration of profile pages from the Admin UI
  • Added missing Admin screen plug-in to allow regen. of profile pages
  • Disabled user searches and user browse views by default
  • Fixed the user setting their profile visibility to "public" / "private" and is now working
  • Added missing CGI script "save" to save the position of the homepage's widgets
  • Added possibility to define locally-defined sizes of the profile pictures
  • Added missing triggers to allow regen of the profile pages when the user's metadata has changed