Developer Hub » Image Settings » Member Post Types - Single Photo
IMPORTANT NOTE: Unless doing heavy customizations to the underlying code of a website's design, there is no need to touch these settings as they will already be optimized for use on a Brilliant Directories website.
This article will cover the image settings for the following:
- Single Photo Post - Thumbnail
- Single Photo 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 That These Settings Apply To
These settings apply to all member post types where one photo can be added to a single post. These post types include:
- Member Article
- Blog Article
- Event
- Coupon
- Jobs
Single Photo Post - Thumbnail Settings
This setting determines the maximum dimensions that single-photo member post type will have when viewed in most locations around the website (homepage streaming widgets, member profile pages, and search results). The only place this setting does not apply is the Details page of the post (the single page devoted to the full post). The setting for the size of the photo on the Details page of the post is set by the "Single Photo Post - Large" setting (see section below). The recommended default settings are a free (open) ratio, a width of 272, and a height of 160.
- The ratio of the Single Photo 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 to 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 "Single Photo 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 type thumbnails are used. Even though 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.
Single Photo Post - Large Settings
This setting determines the maximum dimensions that single-photo member posts type will have when viewed 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 375, and a height of 375. This is also the image used when sharing the Details page of the post on social media.
A single image post will have the Image Upload field directly on the form:
Recommended Size: 750 by 400 pixels
The recommended size text is a text label.
System Variable: recommended_size_single_photo
The articles below will explain how to upload these types of posts:
» How to Post a Community Article
