Midas User's Guide
From MIDAS Wiki
Contents |
Community Agreements
If you are the owner of a community or have administrative privileges you can create or edit an agreement. An agreement will present agreement text to a user and ask them if they agree to the conditions. If they agree to the conditions, they will be able to view the resources within that community; if they do not agree to the conditions, they will not be able to view the resources.
Agreements only are enforced for non-admin users, as admin users have access to all resources. Anonymous users that want to view resources protected by a community agreement will have to first create a login, then agree to the community agreement before viewing those resources.
Multiple community agreements are possible in a hierarchy, the community agreement that is closest to the resource in question will be the relevant community agreement for that resource. If the closest community to a resource does not have an agreement, the community hierarchy is followed all the way up to the top level community, with the first community in the hierarchy that has an agreement being the community agreement used for the resource.
A community agreement contains text, and must be tied to a community agreement group. When a user accepts a community agreement, they are added to the group that is associated with the community agreement. A group can have multiple agreements associated with it, and a user can be a member of multiple groups. Once a user is in a group, they have effectively agreed to all agreements associated with that group.
The group associated with a community agreement can be changed. The text associated with a community agreement can also be changed. To force the user to accept a new community agreement, create a new group and assign the existing community agreement to this new group.
Adding an agreement to a community
You can add an agreement to a community when either creating or editing the community. Let's assume you are creating a new community. (see above creation of community paragraphs)
Once you are in the create community page:
Click on Add community agreement.
Two menus, Select Group and Show Agreement appear.
To write an agreement, you must select a group first. From this menu you can either choose an existing group or create a new one by clicking on create a new group. Once you're done click on Set group to set it as the community group.
You can see on the top right corner the group that is going to be related to the community and agreement.
Once the group is selected, you can write your text: if you want enter rich text rather than plain text, click on [html].
Once you finish, click on Create community.
If you are editing a community, once you are in the edit community page, follow the same instructions.
If you want to delete the agreement, go to the edit community page, remove the agreement and then click on Update community.
Using carts
Using carts requires users to be logged in. Carts are tied to individual users, and the active/default cart is only available during a user's session. So if the user logs in again at a later time, they will need to set the active cart for that later session.
The purpose of the carts is to let users pick the bitstreams/bundles they want from any item across various collections and even various communities, creating a "virtual grouping" of files. Once created, the contents of a cart can be downloaded as a zip file, or used as an input to server side processing tasks.
Manage carts from items
To show the cart menu, click on the cart icon under the item thumbnail.
3 menus appear: Select Cart, Add to Cart and Show Cart
To select a cart you can either select an existing one or create a new one by clicking on create a new cart. Once you're done, click on Set as active cart. On the top right corner, you can see which cart is the active one and how many files it currently has.
Once the active cart is set, you can add files into this cart.
To add files, you just have to select them in the item (you can select bundles and/or bitstreams) and then click on Add Files. If you want to remove all selected files from the list of files to be added click Clear selection.
From the first screenshot, you can see that bundles and bitstreams are distinguished by the icon in front of each bundle.
From the second screenshot, on the top right corner you can see that the number of files in the cart has been updated.
This menu shows you the entire contents of the currently active cart. If your cart has at least one file, you can either download all files in the cart as a zip file, or you can remove all files from the active cart (this will not delete the files from Midas), or you can remove individual files from the active cart (this will not delete the files from Midas).
If you empty the cart, the number of files in it will be updated and set to 0. Deleting files one by one will decrease the number of files in the cart by 1 each time you delete a file.
Manage carts from cart controller
The most important views of the cart controller are lists, view and create.
Lists
This view shows you the user's different carts with, in particular, the number of files that each cart has.
From there, the user can manage his carts in different ways. He can:
- Delete carts
- Make a cart the default/active one
- Create new carts by clicking on create new cart which leads to the create view
- See a cart content by clicking on the cart name which leads to the view of the cart
Create
This view simply allows the user to create a new cart, setting the name and the description (optional) of the cart.
View
In this view, a table shows you all the files that are in the cart. Each file can be deleted from the cart (the file will not be deleted from Midas), or the file can be downloaded by clicking on the filename.
The whole cart can be downloaded as a zip file.
