User view of My Galleries

Link to

(1) Select menu where galleries are displayed in web site

Attention: The menu name may different and may appear in a horizontal menu inside sub menus

(2) Login with your user name given by owner of website The system needs you to be logged in. Otherwise the "My gallery" rights can't be assigned to a user

(3) Click on "My Gallery" link This will lead you to the "My gallery" page where your galleries can be created, images uploaded and edited. This view enables to just see the "owned" galleries and images

First my Galleries user view

(1) Create gallery tab

This is where the fun begins ....

If this tab does not appear the user has not enough rights

Create a gallery

My Gallery: create gallery On the My galleries page click the Create Gallery tab. This tab only shows when the user that is logged in has Create permission.

(1) Select parent gallery To create a new gallery, first choose its parent. Choose "Top gallery" when you want the gallery to have no parent.

(2) Assign a name

(3) Fill out a description (May be empty)

(4) Save (create) gallery with entered settings

Click the little disk button at the top right of the "Create Gallery tab" to save the settings

(5) Cancel creation Click the red round button with a white cross inside to clear all fields.

Saving the gallery details returns you to this page and this tab, but with the extra gallery created (note: this gallery is unpublished by default). Unless of course the user already is at its maximum allowed galleries, then the gallery will not be created.

My Gallery: create gallery done View after first gallery is created

Attention "Add image" is now available

Galleries overview

My Gallery: Galleries overview

(1) Gallery name clicking on the name will lead to the editing page of the gallery

(2) Publish/unpublish gallery

Change the state of a gallery: published or unpublished red/green

In the Published column the user can tell by the icon if the gallery is published (green icon with white check mark) or unpublished (red icon with white dot inside). When the user is not allowed to change the state, the icons are grey, but with either the check mark or the dot. A click on the icon toggles the state from unpublished to published and vice versa.

(3) Delete gallery A gallery can be deleted by clicking on the Delete icon. You will be asked to confirm the deletion of the gallery.

Attention: Images still in the gallery will be deleted as well

(4) Edit gallery

The details like the name and description of the gallery can be edited and a different parent gallery can be chosen. The gallery can be edited by either clicking on the gallery name or on its Edit icon

Doing this shows a new window with the gallery details

Image Upload

My Gallery: Image upload On the My galleries page click the Add Image tab. This tab only shows when the user that is logged in has "Create permission" for one or more galleries.

(1) Select parent gallery

To add your image(s), first choose the gallery that will hold the image(s).

(2) Select a file on your PC / device

You can either add a single image, or a set of images in a zip file. Browse to the file to select it.

There is a restriction of the size of a zip that can be uploaded. It depends on the settings of the server that hosts the web page.

(3) Assign a title

(4) Fill out a description (May be empty)

In case of multiple images in a zip file, this title and description will be used for each image.

(5) Upload gallery with entered settings

To upload your image(s) and save the details, click the disk button at the top right of the Create Gallery tab.

(6) Cancel upload

Next to the disk button is a red round button with a white cross inside. Use this cancel button to clear all fields.

Saving the item returns you to this page and this tab, but with the extra image(s) created

Note: the newly uploaded image will be unpublished by default). Unless of course the user already is at its maximum allowed item, then the items will not be created.

Images overview

My Gallery: Images overview

(1) Check box for selecting multiple images for batch assignment

(2) Title of images

(3) Gallery

Name of the gallery the image belongs to

(4) Publish/unpublish image

Change the state of a image: published or unpublished red/green

In the Published column the user can tell by the icon if the image is published (green icon with white check mark) or unpublished (red icon with white dot inside). When the user is not allowed to change the state, the icons are grey, but with either the check mark or the dot. A click on the icon toggles the state from unpublished to published and vice versa.

(5) Delete image

A image can be deleted by clicking on the Delete icon. You will be asked to confirm the deletion of the image.

(6) Edit image

The details like the title and description of the image can be edited and a different gallery to which the item belongs to can be chosen. The item can be edited by clicking on its Edit icon. Doing this shows a new window with the item details

(7) Batch publish images

The selected images can be published in one go

(8) Batch unpublish images

The selected images can be unpublished in one go

(9) Batch delete images

The selected images can be changed in one go

Edit image

My Gallery: Edit image The properties to be changed are the same like when uploading the image

(1) The uploaded image is displayed in "edit" view

(2) Click on disk button to save the changes

You can save your changes by clicking the disk icon on the top right

(3) Click on the "red cross" button to cancel and reset the changes

You can cancel your changes by clicking the red round icon with the with the cross inside.

Both save and cancel will take you back to the My Galleries page.

Edit gallery

My Gallery: Edit image The properties to be changed are the same like when creating the gallery

(1) Click on disk button to save the changes

You can save your changes by clicking the disk icon on the top right

(2) Click on the "red cross" button to cancel and reset the changes

You can cancel your changes by clicking the red round icon with the with the cross inside.

Both save and cancel will take you back to the My Galleries page.

My Gallery user information

My Gallery: user information

At the top of the page "My Gallery" there is a box with User information: The name of the user who is currently logged in, the number of galleries this user has already created and its allowed maximum (setting Maximum number of galleries a user can have) and the number of items for which the user is the owner and its allowed maximum (setting maximal numbers of pictures a user can have).

My Gallery appearing on main view

My Gallery: external standard view

If the gallery and at least one image is "published" the it appears on the main page below the "My galleries" link and "Search box"

(1) Information buttons

  • The blue "O" appears if the logged in user "owns" this gallery

  • The green "U" appears if you have rights to upload into this gallery

If you hover over the buttons a text explaining will appear

My Gallery: Set it up, get it started

  1. Enable "My Galleries" in RSG2 configuration
  2. Create a user group with rights to handle their own galleries and Images
  3. Assign user rights for this group on
  4. Assign the standard RSGallery2 view to a menu

Configuration of My Galleries

My Galleries configuration

More description in section configuration

Create a user group for "My Galleries" users

My Galleries New user group

A separate user groups helps to assign special rights for "My Gallery" users.

Assign user rights for this "My Galleries" users group

My Galleries configuration

(1) Search for RSGallery2 in System->Global configuration

(2) Select Permissions

(3)-(6) Activate the "Create own", "Delete own", "Edit own", "Edit state own" permissions. The "vote" or "comment" permissions enable actions on the images itself. They are not needed for the handling of galleries and images.

Edit Permission, Edit State Permission (to publish or unpublish an item or gallery), Delete Permission and Create Permission for items and galleries.

A user with none of these permissions can only see the items and galleries, but cannot publish, delete, edit or create items or galleries. That is reflected on the tabs My Images and My galleries by the grey icons for the items and galleries. That user will also not see the Add Image and Create Gallery tabs.

However, when a user has all permissions, the icons are no longer greyed out, and there are two more tabs: Add Image and Create Gallery. A site administrator can choose to give only specific permissions to a user group, e.g. only Edit permission, and only give that permission for a specific gallery. Then the user will see from the icons being grey (and non-functional) or not if they have that permission.

Assign the standard RSGallery2 view to a menu

This may be done already as it is as simple as assigning the standard view to a menu


Pre version for drag and drop


Upload changes for using Drag and Drop

This document describes the changed use created for drag and drop upload of Images

Upload files using drag and drop

The first tab of the new download form looks like following Image. It shows the new drag and drop download area with tab set to drag and drop. Upload startview

Upload files using drag and drop: Page fresh opened

(1) Specify gallery

First select an existing gallery

(2) Drag and drop area

The drag and drop area is marked with a red or green dotted border. The color changes to green when a gallery is selected. An error message appears when a image is dropped while the border is red.
When images are dropped then they are transferred to the server and assigned to the gallery. The display-, thumb- and watermarked images are created and on success the image is displayed in the drag and drop area.
Ass soon as the image is displayed it is secure to assume that the image is stored in the database and assigned to the gallery

(3) Select files

This is an other way to select multiple images form a folder on the PC- Press this button and you can move to the image folder and select several images to be downloaded. On exit these files are downloaded

This is especially helpful if your operation system remembers the last selected folder and displays it again for the image upload

(4) Add image properties

After the dropped images appear (are shown) in their area here is provided a batch handling to assign the properties "title" and "description" More below on description of the "Properties uploaded images" view

Tip: This functionality can also be reached from the image list view. Select the images to be handled and use button batch and the select "Images Properties" button

(5) Upload single images (Legacy) This button leads to the old "legacy" version of single image upload.
When the drag and drop function has enough experience and no user complains then it is faster and this function will be removed

(6) Upload file size On the bottom is shown the setting of some php variables from the system (from php.ini file) related to the upload process. Even if the file itself complies with all limits the upload itself may fail. Example: Sometimes the bytes are transferred as pure ASCII: So 7 bits are used and transferred in one Byte. So the "real" size is 'file size / 7 * 8'

Restrictions

  • Uploading more that 20 Files at once: This may lead to wrong order number as the call to the database is asynchronous and therefore if the system is busy the same order number may generated twice or for several images
  • Filesize: The working file size is not only dependent on the system settings for upload (see point (6)). Also the used library (GD see configuration) may stumble

Upload start view

Upload files using drag and drop: Page after some uploads

(1) Drag and drop area (filled) After a gallery is selected the dotted border is green. Dropped images do appear in this area after the transfer process is completed.

(2) Process bars

For each dropped file a progress bar appears. It is red as long as the file is not completely transferred. In each state it tells the amount of transferred parts of the file.

Attention: Even if the green bar is at 100% telling that the file is completely transferred the server needs time to create the dependent rsgallery2 images and the process is not finished until the matching image is displayed in the drag and drop area

(3) Add image properties A click on button "Add image properties" will lead to a page where properties can be assigned to all shown images at once (batch). The title and the description properties can be edited there. This is similar to the second page on upload in previous rsgallery2 versions.

It is not necessary to use this view when no title or description is needed.

Info: On creation of the image data on the server side the title is preset from the image name automatically.

Upload startview

Properties uploaded Files

This form enables to set the properties title and description for a batch of images at the same time.
It is normally reached over the upload form. It can also be reached with selected images over the batch button in the images list form

(1) Title

The title is preset on creation. It may be edited here. The title may be different to the uploaded image name when the name already existed. Then the next free number is appended.

(2) Gallery

The gallery name may be changed to move the image to a different gallery

The gallery name is fixed in some circumstances. * On drag and drop the gallery name must be assigned already in the upload form * Zip or server side uploads may select the gallery before Uploading * On entering from the images list form the gallery may be changed

(3) Description The description may be changed with the standard editor like in the edit single image form.
Sadly this leads to a very high edit block which creates a ugly layout.

(4) Save

Save changes and continue edit on the same images

(5) Save & Close

Save changes and leave the form to the image list

(6) Cancel

Ignore the changes and leave the form

(7) Delete

All or some image can be selected for deleting. (See (8) and (9)) Clicking on the delete button will delete the selected images from the RSGallery2 database and the created image files

(8) Select all

All images will get a set hook in the box below the image (See also (9)) This can be used to delete selected images.

(9) Select image

The image will get a set hook in the box below the image This can be used to delete selected images.

My Galleries

A site administrator can enable My Galleries for users to upload and view their own galleries (setting Show My Galleries, 'no' by default). A extra element will appear on the gallery view when a user has logged in on the front end.

My Gallery: Standard View of user created "My Gallery" gallery

The "my galleries" are viewed on the module where the menu with type RSGallery2 is displayed. Above the RSGallery2 "Search box" the user can click on "My galleries" link (3) Link to

(Link must be activated in configuration of RSG2)

Clicking on that link will show a page like

First my Galleries user view If tab (1) does not appear the user has not enough rights

Upload

Upload startview Above is the start view when selecting configuration

There are three tabs to choose

  • (1) Single images
  • (2) Upload from Zip file (PC)
  • (3) Upload from folder (server)

Single images

On "Upload single images" a form opens where the properties of a image to be uploaded can be edited. This includes the origin of the image as properties like name, assigned gallery and more.

More images can be added in that form.

Single images

(1) Jumps to single images upload view

See form "Single images upload" view below.

Upload from Zip file (PC)

A zip file containing several images can be uploaded to the server, unzipped and the images assigned to a gallery.

Upload from Zip file (PC)

(1) Select the zip file on local pc folder

Attention: The size of all files within the zip file has to be smaller than the server settings (php.ini) upload_max_filesize and post_max_size. These values are displayed in red below this input.

(2) One gallery for all Images

On yes the selected gallery is used for all images. Otherwise for each image the gallery may be assigned in the next form.

(3) Specify gallery

The list on the right contains all gallery names. The top most gallery is the last one created.

(4) Upload from Zip file

Does upload the zip file to the server, unzip the images and jumps to properties "uploaded images view". There the images are displayed and the properties can be assigned.

See form "Images batch upload" view below

Upload from folder (server)

Images can be uploaded to a folder (Shall be created) within the Joomla! installation. The images will be copied from this folder and will be assigned to the gallery

Upload from folder (server)

(1) FTP Path Defines the path where RSGallery2 will look for images to "upload" The path may be any otherwise empty folder which is accessible (has rights) from within the Joomla! installation. Recommended is a folder TransferImages in images The path must start with the base path to Joomla! installation. To make things easier the standard path is given in small font below the input.

In configuration the standard path can be set so it will be automatically filled in.

(2) One gallery for all Images

On yes the selected gallery is used for all images. Otherwise for each image the gallery may be assigned in the next form

(3) Specify gallery

The list on the right contains all gallery names. The top most gallery is the last one created

(4) Upload images

Does copy the files from given folder on the server and jumps to "Images batch upload" view. There the images are displayed and the properties can be assigned.

See form "Images batch upload" view below

Form "Images batch upload"

This form will be reached either by upload from ZIP or upload from server folder. It supports an overview of uploaded images as pictures and enables to set image specific attributes

Images batch upload second form

(1) Delete: If activated (checked) the image will not be used and delted

(2) Image preview:

(3) Title: Add a text for title displayed with image

(4) Gallery: If selected in previous upload form the gallery can be selected different for each image. Otherwies the input is grey , not reachabel and tells the previous selected gallery

(5) Description: Add a description which is displayed with the image

(6) Button to finish the upload. The attributes will be assinged to the images ...

Form "Single images upload"

Single images upload second form

(1) Gallery: The gallery can be selected different for each image

(2) Generic description: It will be used for all following images

(3) Title: Add a text for title displayed with image

(4) File: Select image to upload

(5) More Files: A click on this item will add inputs for the next image. The area marked green wil be duplicated for input of the next images. This may be repeated as often as needed. (Attention: Limit may be the server time for the upload itself)

(6) Button to finish the upload. The attributes will be assinged to the images ...

(7) Cancel the process

General folders of rsgallery2

(2017.07.17) .... The images are kept in following folders in .../Joomla/images/rsgallery/tmp

  • original: Users original images if not disabled in configuration
  • display: Resized images (size from configuration)
  • thumbs: Thumbs of images (size and form from configuration)
  • watermarked: When watermark is active then images which were shown to the user get a watermark and are saved here for fast access