First steps (3) Create a menu to view galleries

Control base buttons. galleries marked

(1) Select Menus -> Main menu and use "Add new Menu Item"

Control base buttons. galleries marked

(1) Add menu name
(2) Click on select button

Following image will appear

Control base buttons. galleries marked

(1) Click on Rsgallery2 to open the two possible menu types provided by RSGallery2
(2) Click on view of galleries to assign a gallery view to the Menu
(3) Click on Slideshow to assign a slide show to the Menu

The click leads back to a changed menu item definition

Control base buttons. galleries marked

(1) Choose Gallery from (partly hidden) list
Select either a single gallery or a gallery overview
(2) Gallery overview
Selecting "Gallery overview" item shows a set of galleries to the user. Depending on the configuration definitions there may additional images list displayed like "latest images"
(3) Select an single gallery
Then only this gallery is shown when the user selects this menu

Menu user view example

Number of shown galleries can be predefined in the configuration

Control baase buttons. galleries marked

The appearsrance of Random images and latest images can be predefined in the configuration

Control base buttons. galleries marked

Hint: Representing gallery image

When images are assigned to a gallery the gallery is represented by a image inside the gallery. This can be a random image or a selected one. The setting can be assigned inside the edit view of the gallery.


Next steps:

Upload

Upload startview

There are three tabs to choose * (1) Upload by drag and drop * (2) Upload from Zip file (PC) * (3) Upload from folder (server)

Upload by drag and drop

On "Upload by drag and drop" 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.

Drag and Drop

(1) Specify gallery

First select an existing gallery This will enable drag and drop ands display the drop area in green

(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 drag and drop 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.

Restrictions

  • File size: The upload may hang if the file size is too big. 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 files using drag and drop: View after some uploads

Upload start view

(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 editing needed.

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

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) Specify gallery

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

(3) Upload 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 section "Properties uploaded Files" view below ToDo: Link

(4) Upload Zip file (legacy)

This button leads to the old "legacy" version of zip file upload.
When the new function has enough experience and no user complains then this function will be removed.

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) Specify gallery

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

(3) 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 ToDo: link

(4) Upload Zip file (legacy)

This button leads to the old "legacy" version of zip file upload.
When the new function has enough experience and no user complains then this function will be removed.

Properties uploaded Files

Upload startview

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 can't be changed in this part

(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) Rotate left

Rotates selected images 90 degrees against the clock

(9) Rotate right

Rotates selected images 90 degrees with the clock

(10) Rotate 180

Rotates selected images 180 degrees.

(11) Flip horizontal

Flips the selected images horizontal. The bits move from left to right. The bottom of the image keeps being the bottom

(12) Flip vertical

Flips the selected images vertical. The bits move from bottom to top. The left/right side of the image keeps being the left/right side

(13) Select all

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

(14) Select image

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

Images: Batch process to add properties

In the images list view images can be selected for batch processing. The following image shows the possible selections which appear after clicking the batch button

Upload startview

(1) Add properties

This button leads to the properties form (See above) and will open the selected images. So the title and description can be changed for a batch of images

How to fix ajax upload errors

In cases where the the upload got stuck you may see a error message and the result looks like below

....

In most cases the image data is reserved in the database but the image is not uploaded.

Then you may upload the image by FTP to the rsgallery2 "original" destination folder and start the creation of the display and thumb images manual by using a maintenance function

1. Check the database reservation / images existence

Upload startview

In "control panel" select Maintenance

Upload startview

There select in section "Repair zone" the button "Consolidate image database". This will lead to a page where it is checked whether there are database entries for missing images or for images with no database / gallery connection

Upload startview

2. Upload image

The original images are kept in folder in .../Joomla/images/rsgallery/original. Copy your file into this folder.

Upload startview

(1) Use button "Repeat checking" so the image is found
(2) If the image exists it is marked here
(3) Select the line with clicking on marker in front
(4) Use button "Create missing images".
If all goes well then the line of this image will disappear in the next display of the page

General folders of RSGallery2 images

(2018.07.03) ....

The images are kept in following folders in .../Joomla/images/rsgallery/sub_folder * 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

Galleries List View

Has to be continued ...


...

...

Change Ordering

(1) Click on up and down of the order controls or change the value there.

This will automatically update all other ordering controls but not save to the database

(2) Use the grren "OK" button to write the changes to the database

See following image

The sorting depends on parents and child galleries. Child galleries will be ordered direct behind their parent. This applies also to sub - childs when theparent is a child itself. Then a cascade of childs and sub childs will follow the first parent.

(3) While changing the "first gallery" from 5 down to 2 the child gallery "a subgallery" will always follow having a ordering with 1 higher. Result see below

Sadly this has a side effect. If you try to increase the parent gallery ordering it will not go up through clicking. You may set te value by key which works when leaving the control.


...

Images - List view

Has to be continued ...


-> In processing, parts present (2018.07.22)

Configuration

Config startview

Above is the start view when selecting configuration

  • (1) There are four tabs to choose

    • General: Debugging and SEF
    • Images: Image related settings
    • Display: Frontend view relating settings
    • My Galleries: Settings for user galleries

  • (2) Sections in Tab

Each Tab contains sections. A click on a section will open or hide the settings within while the other sections stay open or hidden

General

General settings

  • (1) Version:

    Tells the actual uploaded RSG2 version.

  • (2) Introduction Text

    This text is used as a broad header description of the "root gallery" view. The root gallery (with sub galleries and more) will be displayed when the menu type "RSGallery2 -> View of galleries" is activated and the root gallery is chosen for display

  • (3) Debug

    Activates debug functionality. This does write calling parameters and logs some of the used files / classes in a log file.

    Attention: On Yes to Debug a log file per day will be created in folder '...//joomla root/administrator/log' and notices may appear on top of a form. Please delete log files regularly". In Maintenance will (may be in near future) be a button to achieve this

    Actually (22.07.2018) Using debug on the frontend will create a lot of text in the log files and may get stuck when a lot of users are active. It is best used on the local test web then.

  • (4) Develop

    Activates developer functions. Additional 'info' will appear in HTML pages and more functions appear in maintenance view. The additional function may not work or destroy parts of RSGallery2 ....

  • (5) Advanced SEF

    All gallery names and item titles must be unique


Images

Images: Image Manipulation

Image manipulation

  • (1) Display Picture Width

    Standard size of displayed image. The downloaded file will be resized to this width for the standard display of the image. The original image is still kept for modal display when clicking on a gallery image

  • (2) Thumbnail Width

    Defines the with of the small images (thumbs) in gallery tile view

  • (3) Thumbnail Style

    The thumbnail may be sized (styled) for "Square" or "Proportional" dimensions. In "Square" Style the height of the thumbnail is the same as the width. In "Proportional" Style the height is calculated according the width/height proportions of the original image.

  • (4) JPEG Quality Percentage

    Defines the quality factor will be used by the resizing from original image to the displayed image

  • (5) Allowed file types

    This information tells which file types are supported. The types are defined by the component and therefore can't be changed


Images: Image upload

Image manipulation

  • (1) FTP Path:

    Used as initial value in upload (ftp tab) form. Used for uploading images from folder path on remote server. Path must start with base path to the joomla! installation

  • (2) Use IPTC information Yes No

    If set to yes: If a file has IPTC information in the fields title (2#005) and description (2#120), then this information will be used upon import of an image in RSGallery2, unless the title and description fields shown in the import steps are used.

<

p>If set to no: IPTC information will not be used.

  • (3) Default state for uploaded images

    Select between "Published", "Unpublished", "Archived" or "Trashed"

    If a user has either Edit State permission or Edit State Own permission and he uploads an item in a gallery he owns (e.g. the user is allowed to change the state from Published to Unpublished and vice versa for images in the selected gallery), then this value indicates whether the uploaded images will be (un)published by default. This setting applies to Frontend as well as Backend, and for single file and batch upload.

    For users without Edit State permission the default state is Unpublished.

  • (4) Preselect 'One gallery for all images', Default Yes No

    Preselect state for upload form. Yes: Use selected gallery for all images. No: select images in second step

  • (5) Preselect latest gallery Yes No

    Preselect the 'Latest gallery' name as default selection in upload form


Images: Graphics Library

Image manipulation

  • (1) Graphics Library

    Old:
    Three graphics libraries, GD2, ImageMagick (and Netpbm, are supported if they exist on the server. They are used to make display and thumb-nail images on upload of images

    Actually only GD2 is used until further notice

  • (2) ImageMagick Path

    Path to the ImageMagick library on the server

  • (3) Netpbm Path

    Path to the Netpbm library on the server

  • (4) Video converter path

    Videos are actually not supported

  • (5) Video converter parameters

    Videos are actually not supported

  • (6) Thumbnail extraction parameters

    Video Thumbnail are actually not supported

  • (7) Video output type

    Videos are actually not supported


Images: Image Storage

Image manipulation

  • (1) Keep original image Yes No

    On "yes" the original image will be deleted after the upload process for server space or hiding purposes. On a double click of the display sized image the same image (size) appears then in the popup

    Drawback: watermark images not created on upload will use the smaller size "display" image to be build when the user opens the 2original" view"

  • (2) Original Image Path

    Select any folder within the Joomla! reachable folder system. You may choose a different folder when you don't show the original images by setting the "Popup style to none" in Configuration -> Tab "display" -> section "Image display". This makes it harder for any user to guess the origin folder to download the original image with big size and good quality .

  • (3) Display Image Path

    Select any folder within the Joomla! reachable folder system for the resized displayed images.

  • (4) Thumb Path

    Select any folder within the Joomla! reachable folder system for the thumb images.

Future folder structure (2018.07.22)

Actually all images of a certain type are kept in one folder. This limits its use as the amount of files per folder is limited. It may limited to 60000 files on older systems and on around 4 Gbyte files on newer. Anyhow the system catches performance issues after too many files in one.

The development team aims for folder per gallery so other slide shows may benefit from this too.


Images: Comments

Comments are activated in configuration under Tab "Display -> section "Image display"

Image manipulation

  • (1) Use CAPTCHA check, in comment form Yes No

    .

  • (2) CAPTCHA type

    .

  • (3) CAPTCHA image height in px (width is 2.7*height)

    .

  • (4) CAPTCHA perturbation (1.0 is high, the higher the more distorted; 0.75 is fine)

    .

  • (5) Number of lines to distort the CAPTCHA image with

    .

  • (6) CAPTCHA background color (hexadecimal code, e.g. #0099CC)

    .

  • (7) Textcolor (hexadecimal code, e.g. #EAEAEA)

    .

  • (8) Color of lines (hexadecimal code, e.g. #0000CC)

    .

  • (9) Alfanumeric CAPTCHA is case sensitive recommended setting: No) Yes No

    .

  • (10) Characters to use for alfanumeric CAPTCHA

    .

  • (11) Length of code for alfanumerc CAPTCHA


Images: Voting

Voting is activated in configuration under Tab "Display -> section "Image display"

Image manipulation

  • (1) User can only vote once (cookie based) Yes No

    Defines if a user can vote multiple times ToDo: ? overwrites old voting or adds further voting

  • (2) Cookie prefix

    A cooky is used to track the user on voting. Assign a singular prefix only used from your web site


Display

Display: Front Page

Image manipulation

  • (1) Display Search Yes No

    Displays a search rectangle over the gallery display. ToDo Check: The user may search for gallery names, images names, in the descriptions and in the comments.

  • (2) Display Random Yes No

    On yes an area appears below the standard gallery where Random images are displayed

  • (3) Display Latest Yes No

    On yes an area appears below the standard gallery where Random images are displayed

  • (4) Display Branding Yes No

  • (5) Display Downloadlink Yes No

    .

  • (6) Display Status Icons Yes No

    .

  • (7) Display gallery limitbox

    .

  • (8) Default number of galleries on frontpage

    .

  • (9) Display Slideshow Yes No

    .

  • (10) Select slideshow

    .

  • (11) Display Owner Information Yes No

    .

  • (12) Display number of items in gallery Yes No

    .

  • (13) Include items in child galleries when displaying number of items in a gallery Yes No

    .

  • (14) Display creation date Yes No


Display: Image Display

Image manipulation

  • (1) Display Slideshow in item view Yes No

    Adds a "slideshow" link to the single image view. It leads to a page displaying the selected type of slideshow

  • (2) Popup style Defines the method ("No popup", "Normal popup", "Joomla Modal") used for displaying a popup (big image) after a click of the image in single image display.

    "No popup": A click on the image does not open a popup
    "Normal popup": After click on the image the original image is displayed in a separate browser window style
    "Joomla Modal": After click on the image a popup in a modal style with [x] to close appear in front of the small image screen

  • (3) Display Description Yes No

    On "Yes" a rectangle below the single image display is added. It contains a header with title "Display" and below a field where the description of the image is displayed.

  • (4) Display Hits Yes No

    On "Yes" a rectangle below the single image display is added. It contains a header with title "Hits" and below a field where the number of "hits" of the images is displayed.

  • (5) Display Voting Yes No

    On "Yes" a rectangle below the single image display is added. It contains a header with title "Comments" and below a field where comments can be inserted.

  • (6) Display Comments Yes No

    On Yes a rectangle below the single image display is added. It contains a header with title "Comments" and below a field where comments can be inserted.


Display: Image order

Image manipulation

  • (1) Order images by

    The displayed imaged may be ordered by the types "Default", "Date", "Name", "Rating" or "Hits

  • (2) Order direction

    The appearance of order type (see above) can be displayed in ascending or descending order


Display: EXIF settings

Image manipulation

  • (1) Display EXIF Data Yes No

    If the image contains EXIF data these may be displayed as info in a rectangle below the image in the single image view It appears beside Description, Voting and Comments in a separate table part

  • (2) Select EXIF tags to display

    Select the information which shall be shown to the user. Multiple selections are supported

  • (3) Selected items box

    A items listed here are selected for display

  • (4) Possible properties list

    Shows a list of selectable exif properties. Inverted items are selected


Display: Gallery View

Image manipulation

  • (1) Thumbnail Style:

    "Table", "Float" or "Magic" Use float for variable width templates sorry "Magic" -> not supported (yet) "Table": The thumb nails are embedded in table elements
    "Float": The thumb nails are embedded in an unordered list

  • (2) Direction (only works for float) Assigns the direction "Left to right" or "Right to left" of the unordered list elements

  • (3) Number of Thumbnail Columns (only for table)

    Number of thumbnails in a row

  • (4) Thumbnails per Page

    Set the maximum thump nails displayed on one page. There will be a page navigation displayed if the gallery contains more images.

  • (5) Show image name below thumbnail Yes No

    On yes the image name will shown below the thumbnail

  • (6) Navigation bar display

    Adds a navigation bar in the single image display of the gallery Possible selections: Top, bottom, both, none

  • (7) Display Slideshow in gallery view Yes No

    Adds a "slideshow" link to the gallery view. It leads to a page displaying the selected type of slideshow


Display: Image Watermark

Image manipulation

If you consider using watermarked files see also description "How to hide the original image from the user"

  • (1) Display watermark

    Activate if watermarked files should be used on "big size" image view. It will replace the original file which would be displayed otherwise.
    A watermarked replacement file will be created once when uploading or when viewed the first time. The watermarking will be a text defined in the configuration.
    Optional: Add icon or other image as watermark. (This has to be developed. It can be done in short time. Send us an email if you need it and we will care for it)

  • (2) Watermark Type

    The watermark may be merged from "text" or from an "image" into the display image

  • (3) Font

  • Select the font type of the watermark text

  • (4) Watermark text

  • Define the text to be displayed in the image

  • (5) Watermark font size

    Select the font size of the watermark text

  • (6) Watermark text angle

    Define the angle of the watermark text

  • (7) Watermark image

    Will be merged into the big display image. Watermark image should be smaller then display image

  • (8) Scale watermark image

    Enter a factor to enlarge the watermark image. 1.0 will use the original. Smaller values will reduce the watermark image size

  • (9) Watermark position

    Select the position of the watermark text

  • (10) Margin from top

    -> Not used

  • (11) Margin from right

    -> Not used

  • (12) Margin from bottom

    -> Not used

  • (13) Margin from left

    -> Not used

  • (14) Watermark transparency

    Define transparency of the text to be displayed in the image. A higher value makes the watermark more transparent. Transparency of 100% makes the watermark invisible

  • (15) Watermark image path

    Define the destination path of the created watermarked files


My Galleries

My galleries supports the creation of user galleries

My Galleries

Settings My Galleries

  • (1) Show My Galleries

    On yes it avtivates this functions

  • (2) Show only items owned by the logged in user in My Galleries

    Restricts the shown images on front end to users who own the image and who are logged in.

    ??? The images of the user may be in several galleries owned by other people. ???

  • (3) Show only galleries owned by the logged in user in My Galleries Yes No

    Restricts the shown galleries on front end to user who own the gallery and who are logged in.

Image upload

  • (4) Maximum number of galleries a user can have

    Restrict the amount of galleries a user may create

  • (5) Max numbers of pictures a user can have

    Restrict the amount of images a user may upload. It counts number of images over all galleries


Config - Documentation

Started to create document 2017.07.09 ..., additions 2017.10.20, 2017.11.25,

Partially finished


How to hide the original image from the user

Intention:

You want to show your images to the customers but the customer shouldn't be able to download in original resolution. The RSGallery2 supports this with some small drawbacks.

We can't avoid that every image that is shown in the browser the user can download which is not what you want.

Solutions:

  • Prevent showing the original image on double click on the image
  • Automatic remove the original size image file after upload
  • Display a watermarked file instead of the original image

Display types in RSGallery2

  • "Thumbs": Shown in gallery overview ==> No need for watermarking
  • "Display": Single image view in slideshow and similar views ==> Expected to be resized into lesser quality and therefore no watermark.
  • "Original": A double click on a "display" image leads to a full screen "lightbox" image of the original file.

Solution "Popup style to none":

Configuration -> Tab "display" -> section "Image display" Image manipulation

  • (2) Popup style Defines the method ("No popup", "Normal popup", "Joomla Modal") used for displaying a popup (big image) after a click of the image in single image display.

    Possible selections:

    • "No popup": A click on the image does not open a popup or display the "original" image in a separate window
    • "Normal popup": After click on the image the original image is displayed in a separate browser window style
    • "Joomla Modal": After click on the image a popup in a modal style with [x] to close appear in front of the small image screen

    Choose "No popup" to avoid the download of the original size image. Then the user will only see the small sized "display" image.

    Drawback
    • The "original" files can be found and opened in the browser with guessing if a knowledge of the RSGallery2 / Joomla structure exists.
      This can be disguised using a different folder for originals (see configuration image below)

Solution "Automatic remove the original size image file":

Configuration -> Tab "Image" -> section "Image Storage"
Image manipulation

  • (1) Keep original image Yes / No

    On "yes" the original image will be deleted after the upload process for server space or hiding purposes. On a double click of the display sized image the same image (size) appears then in the popup

    Drawback:

    Watermark images not created on upload will use the smaller size "display" image to be build when the user opens the 2original" view"

Solution "Watermarked files":

1) Resized display image (to bad quality) On upload the original image it is resized to display size defined in configuration. This reduces "interest" of your user to download with this bad quality

2) Watermark A watermarked replacement file will be created once when uploading or when viewed the first time. The watermarking will be a text defined in the configuration.
Optional: Add icon or other image as watermark. (This has to be developed. It can be done in short time. Send us an email if you need it and we will care for it)

3) Disguise watermarked file names Additional the created watermarked files are disguised with a different filename. So users can't immediately guess the URL of the next or previous image. So it is harder to download all your images and remove the watermark with an imaging application

##### Drawbacks * The small sized "display" files have no watermark * The "display" files can be found with guessing and a knowledge of the RSGallery2 / Joomla structure * If you switch on watermarking after uploading the images then the watermarking tries to use the original image. If it doesn't exist then it uses the "display" files with lower resolution.

Setup watermarked configuration:

  1. Hide (delete) original after upload

    Image manipulation

    In configuration->images->section "Image storage"

    • (1) activate the "no" selection
  2. Check "display" resolution

    Image manipulation

    In configuration->images->section "Image manipulation"

    • (1) Display picture width defines the maximum size of the displayed image.
    • (2) You can reduce the quality of the displayed image to your needs
  3. Check watermark settings

    Image manipulation

    In configuration->display->section "Image watermark"

    • (1) Display watermark
      Activate if watermarked files should be used on "big size" image view. It will replace the original file which would be displayed otherwise.
      A watermarked replacement file will be created once when uploading or when viewed the first time. The watermarking will be a text defined in the configuration.
      Optional: Add icon or other image as watermark. (This has to be developed. It can be done in short time. Send us an email if you need it and we will care for it)
    • (2) Watermark type
      A text or an image can be merged into the original image as a watermark
    • (3) Watermark text
      Define the text to be displayed in the image
    • (4) Font
      Select the font type of the watermark text
    • (5) Watermark font size
      Select the font size of the watermark text
    • (6) Watermark text angle
      Define the angle of the watermark text
    • (7) Watermark image
      Will be merged into the big display image. Watermark image should be smaller then display image"
    • (8) Scale watermark image
      Enter a factor to enlarge the watermark image. 1.0 will use the original. Smaller values will reduce the watermark image size
    • (9) Watermark position
      Select the position of the watermark text.
    • (10) Margin from top
    • (11) Margin from right
    • (12) Margin from bottom
    • (13) Margin from left
      Margin from the border of the original image. Watermark is placed with distance to the border, if it is not centrally located
    • (14) Watermark transparency
      Define transparency of the text to be displayed in the image
    • (15) Watermark image path
      Define the destination path of the created watermarked files

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 "My gallery" view 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 "My Galleries"

(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


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


User view of My Galleries

Link to "My Galleries"

(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


PDF documentation

The Documentation was written at the time of Joomla 2.5.

The screenshots are therefore old, however,things work still quite the same

As you may see above we are working on improvement (part after part)


RSGallery2_documentation_J3.x.pdf

Maintenance functions

To be continued

Drag and Drop

Drag and Drop


Control Panel

Upload startview

(1) Function buttons

A click in the grey area will lead to the named section.
More see below

(2) RSGallery2 overview Tells about installed version and tells about interesting RSGallery2 links

(3) Last galleries and images overview area Shows a list of the latest galleries and a list of the latest images

(4) Credits

A click on credits opens an area where all the contributors to RSGallery2 are mentioned. More below

(5) Info about version and copyright

Function buttons

Upload startview

(1) Configuration

Enables the configuration of Image settings, Display settings and MyGallery settings

(2) Manage Galleries View gallery list , create new galleries, edit gallery, publish ...

(3) Upload Opens view for upload with "Drag and drop", upload "from Zip" or Upload "from server folder"

(4) Manage images View images list , create new images, edit image, publish ...

(5) Maintenance For maintenance exist a "Repair Zone" where content can be checked for consistency, a "Danger zone" to remove the component and a Raw database zone" to see more content of gallery and images list.

credits

Area where all the contributors to RSGallery2 are listed. See parts in image below.

Upload startview