Hosting Forums Market
Osclass

Media

Configure how your site handles images - media settings. Adjust which uploader library to use, define maximum image dimensions, enable or disable watermarks, and regenerate thumbnails for existing images.

Media settings
Media settings

General Settings

  • Image Uploader Library: Choose the technology for handling uploads. Options include Uppy.io (modern drag-and-drop support), FineUploader (classic), or Legacy (no uploader) for a very basic fallback.
    Tip: Thoroughly test uploads on the “Publish a Listing” page if you change this setting.
  • Force Replace Libraries: When checked, attempts to override any theme’s native uploader and enforce the library selected above (Uppy.io only).
    Disable if your theme already supports Uppy.io out of the box.
  • Reorder Uploaded Images: Lets users drag and reorder images when posting or editing a listing (Uppy.io only, requires jQuery UI in your theme).

Image Sizes

Do not setup larger images than you really need! You save space, server resources and item publish will be faster.

  • Thumbnail Size: Maximum width and height (e.g., 240x200) for the smallest preview version of each uploaded image.
  • Preview Size: Slightly larger than thumbnail (e.g., 480x340), used in certain listing views or lightboxes.
  • Normal Size: Usually the main display dimension (e.g., 640x480).
  • Keep Original Image: If enabled, stores a full-resolution copy of every uploaded image, potentially using more disk space.

Additional Settings

  • Force JPEG: Converts all images to JPEG. Saves storage but removes transparency (e.g., PNG backgrounds).
  • Crop Image (Best Image Crop): Crops the image from the center to fit the specified dimensions without padding or white space.
  • Force Aspect: Enforces aspect ratio resizing without adding white bars. Has no effect if “Best image crop” is already on.
  • Maximum Size (KB): Sets the largest file size (in KB) that can be uploaded. You’ll see a note about the PHP maximum file size limit as well.
  • ImageMagick: If available, Osclass can use ImageMagick for faster processing and lower resource usage instead of the default GD library.
  • Canvas Background: Select a default background color (white/black) for images that need extra space to match dimensions, unless “Best crop” or “Force aspect” overrides it.

Watermark

  • Watermark Type:
    • None: No watermark applied.
    • Text: Overlay a text watermark (requires the FreeType library).
    • Image: Overlay a PNG image at the chosen position.
  • Text Settings: When text is selected, specify the watermark text, color (hex code), and position (center, top-left, top-right, bottom-left, bottom-right).
  • Image Settings: When image is selected, upload a PNG watermark and specify positioning as above. Osclass won’t validate the watermark’s dimensions, so make sure it’s sized appropriately.
  • Recommendation: Keep the “Keep original image” option active if you use watermarks. Otherwise, once a watermark is baked in, you can’t revert to a clean original.

Regenerate Images

  • Purpose: If you adjust thumbnail, preview, or normal size settings, you might want to rebuild existing images to apply the new dimensions.
  • Process: Large sites with many images can take a long time to regenerate. You may need to increase PHP’s max_execution_time and memory limits to avoid timeouts.
  • Continue / Refresh: If the process fails midway, simply revisit this page. Regeneration restarts at the last processed image, so you can continue in batches.

After changing any of these options, click Save changes to store your updated media configuration. Always test thoroughly, especially when switching uploader libraries or applying watermarks.