Developer Hub » Image Settings » Member Post Types - Multiple Photos

Link: https://support.brilliantdirectories.com/support/solutions/articles/12000019277-developer-hub-image-settings-member-post-types-multiple-photos

IMPORTANT NOTE: Unless doing heavy customizations to the underlying code of a website's design, there is no need to edit these settings as they already are optimized for use on a Brilliant Directories website.


This article will cover the image settings for the following:

  • Multiple Photos Post - Thumbnail
  • Multiple Photos Post - Large


When viewing the Image Settings page, the settings covered here can be seen in this section:




We also have the following articles available that cover the other sections:


Default Member Post Types These Settings Apply To

These settings apply to all member Post Types where multiple photos can be added to a single post.  These Post Types include:
  • Property
  • Product
  • Photo Album
  • Classified


Multiple Photo Post - Thumbnail Settings


This setting determines the maximum dimensions that multiple-photo member Post Types will have when viewed in most locations around the website (homepage streaming widgets, member profile pages, thumbnails in the album viewer on Details pages, and search results).  The only place this setting does not apply is the Large version of the image on the Details page of the post (the single page devoted to the full post).  The setting for the size of the large version of the photo on the Details page of the post is set by the "Multiple Photos Post - Large" setting (see the section below).  The recommended default settings are a free (open) ratio, a width of 272, and a height of 160.


  • The ratio of the Multiple Photos Post - Thumbnail will always be "Open" so members are not forced to upload an image that is a certain shape - it can be square, wider than it is tall, or taller than it is wide.

  • Since the ratio is always "Open", the "Width" and "Height" numbers serve as limits for the maximum width and height of the image.  For example, if both the Width and Height are set to 200px, and a member uploads an image that is 2000px wide x 2000px tall, the final image will be resized to be 200px wide x 200px tall, maintaining the same aspect ratio of the original image, but downsizing it to be no more than the 200px x 200px limit. This helps ensure that the website loads these images as quickly and efficiently as possible, thus reducing the overall time to load all of the website's pages as much as possible.

  • As another example, if both the Width and height are set at 200px, and a member uploads an image that is 2000px wide x 1000px tall, the image will be resized so that it fits within the limits of 200px x 200px, without changing the aspect ratio.  In this example, the final uploaded image would be 200px wide x 100px tall so it fits within the 200px x 200px limit without changing its aspect ratio or stretching / distorting the image.



  • If the "Multiple Photos Post - Thumbnail" width is set to be less than 160px, an error message will appear:


    ** This is done to make sure that large images are resized to dimensions that will look relatively uniform in the various areas of the website where single photo member Post Types thumbnails are used. Even though the images can be set to be smaller than the default settings, we do not recommend doing so unless customizing the underlying code of the website's design to accommodate these smaller images.


    The Width and Height settings can be set as high as needed, but please note doing this will not cause the images to DISPLAY larger around the site, The image itself will be saved at a larger size, but will be shrunk down to fit into the space available for it when displayed on the website. In other words, all of the images will take longer and use more bandwidth to load, and will not display any larger on the website. Making these images larger will only be useful if heavily customizing the underlying code of the website's design to accommodate these larger images.


Multiple Photo Post - Large Settings


This setting determines the maximum dimensions that multiple-photo member feature posts will have when viewed as the primary photo in the album viewer on the Details page of the post (the single page devoted to the full post).


 

The recommended default settings are a free (open) ratio, a width of 750, and a height of 400.  This is also the image used when sharing the Details page of the post on social media.



A multiple image post will have the Image Upload field in a separate tab:



Recommended Size: 750 by 400 pixels



The recommended size text is a text label.


 System Variable: photo_albums_recommended_size




The articles below will explain how to upload these types of posts:


» How To Post A Photo Album

» How to Post a Product

» How to Post a Property

» How to Post a Classified