=== Directorist Logo Field ===
Contributors: goldenchamber
Tags: directorist, directory, logo, image upload, custom field
Requires at least: 5.6
Tested up to: 6.4
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a custom Logo image field type to Directorist that displays as an image instead of a download link.

== Description ==

Directorist Logo Field extends Directorist to add a proper logo/image field that displays the uploaded image visually in directory listings, rather than as a downloadable file link.

**Features:**

* Custom "Logo Image" field type in Form Builder
* Drag-and-drop image upload
* WordPress Media Library integration
* File type validation (JPG, PNG, GIF, WebP)
* Configurable display dimensions
* Works with Single Listing Layout
* Works with All Listings Card Layout
* Responsive image display
* Shortcode support

== Installation ==

1. Upload the `directorist-logo-field` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Directory Listings > Directory Builder
4. In the Form Builder tab, drag the "Logo Image" field to your Add Listing form
5. In the Single Listing Layout tab, drag the "Logo" widget where you want it displayed
6. In the All Listings Layout tab, add the "Logo" widget to your card layout

== Configuration ==

**Form Field Settings:**

* Label: Text label for the field
* Placeholder: Instructions shown in the upload area
* Required: Make the field mandatory
* Max File Size: Maximum upload size in KB (default: 2048)
* Display Width: Width for displaying the logo (default: 200px)
* Display Height: Height for displaying the logo (default: 100px)

**Layout Widget Settings:**

* Display Width: Maximum width for the logo image
* Display Height: Maximum height for the logo image
* Show Label: Whether to show the field label

== Shortcode ==

Display a listing's logo anywhere using:

`[directorist_logo id="123" width="200" height="100"]`

Parameters:
* `id` - Listing ID (optional, uses current listing if not specified)
* `width` - Maximum width in pixels
* `height` - Maximum height in pixels

== Frequently Asked Questions ==

= Why not use the built-in File Upload field? =

The built-in file upload field outputs files as download links. This plugin creates a proper image field that displays the logo visually.

= What image formats are supported? =

JPG, JPEG, PNG, GIF, and WebP formats are supported.

= Can guests upload logos? =

Yes, if you have guest listing submission enabled in Directorist settings.

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release of the Directorist Logo Field plugin.
