=== Finspire Creative Role-Based Logo ===
Contributors: pinnaclemarketing
Tags: shortcode, logo, user roles, members, branding
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.3.7
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display a role-specific logo with a shortcode.

== Description ==

Finspire Creative Role-Based Logo lets membership sites assign logos to WordPress user roles and display the correct logo with a shortcode.

Key features:

* Display a role-based logo with the `[finspire_role_logo]` shortcode
* Set a default logo when no role-specific logo is assigned
* Define logo width and height per role in the admin page
* Override width and height directly in the shortcode when needed
* Use the shortcode in pages, templates, or other shortcode-friendly content areas
* Manage all logo assignments from Users > Finspire Creative Role-Based Logo

The plugin adds a management page under Users where administrators can set:

* A default logo
* A role-based logo for each registered WordPress role
* Optional width and height settings for each logo

Use `[finspire_role_logo]` anywhere shortcodes are supported.

Shortcode examples:

* `[finspire_role_logo]`
* `[finspire_role_logo width="180"]`
* `[finspire_role_logo width="180" height="60"]`
* `[finspire_role_logo class="site-company-logo"]`
* `[finspire_role_logo link="https://finspirecreative.com"]`
* `[finspire_role_logo role="company_a"]`

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/finspire-creative-role-based-logo/`, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to Users > Finspire Creative Role-Based Logo.
4. Copy the shortcode and assign logos to your roles.
5. Add `[finspire_role_logo]` anywhere shortcodes are supported.

== Frequently Asked Questions ==

= Will new roles appear automatically? =

Yes. The settings page reads the current WordPress roles dynamically when it loads.

= Does sizing stretch the image? =

No. When width or height is set, the plugin uses `object-fit: contain` so the image keeps its aspect ratio.

= Can I override the saved dimensions in a specific shortcode? =

Yes. Use attributes such as `[finspire_role_logo width="180" height="60"]`.

= What happens if a user has multiple roles? =

The plugin uses the first role assigned to the user that has a logo configured.

= What happens if no role-based logo is assigned? =

The plugin will use the default logo when one is set. If no default logo is set, it outputs nothing.

= Will this work with SVG logos? =

Yes, as long as your WordPress site safely allows SVG uploads. The plugin uses the Media Library attachment that you assign to the role or default logo.

= Where do I manage the logos? =

Go to Users > Finspire Creative Role-Based Logo in the WordPress admin area.

== Screenshots ==

1. The Finspire Creative Role-Based Logo admin page with the branded support panel and shortcode panel.
2. The role-based logo settings table with default logo and per-role image sizing controls.

== Upgrade Notice ==

= 1.3.7 =
This release updates internal naming to satisfy WordPress.org review requirements and changes the shortcode to `[finspire_role_logo]`.

== Changelog ==

= 1.3.7 =
* Renamed class, shortcode, settings group, and option names to use the `finspire_rbl_` / `Finspire_Creative_Role_Logo` prefix to comply with WordPress.org naming guidelines.
* Shortcode is now `[finspire_role_logo]` (was `[role_logo]`).

= 1.3.6 =
* Fixed logo width and height settings not taking effect in Elementor Pro and themes such as Hello Elementor. The HTML width/height attributes now reflect the configured dimensions so page builders use the correct size, and max-width/max-height are included in the inline style to prevent theme CSS from overriding the specified dimensions.

= 1.3.5 =
* Added a version query string to the admin panel logo URL to avoid stale browser or CDN cache.

= 1.3.4 =
* Updated the admin support email address.
* Changed the admin support and shortcode panels to a two-column desktop layout.

= 1.3.3 =
* Added a branded Finspire Creative logo to the admin support panel.

= 1.3.2 =
* Added Finspire Creative contact information to the admin page.

= 1.3.1 =
* Updated the plugin name and slug to Finspire Creative Role-Based Logo.

= 1.3.0 =
* Rebranded the plugin with a Finspire prefix for WordPress.org naming guidelines.
* Updated the plugin slug and text domain.

= 1.2.2 =
* Removed the disallowed update header because WordPress.org-hosted plugins must use the WordPress.org update system.
* Added the plugin languages folder.
* Added missing translator context and escaped the admin image preview output.

= 1.2.0 =
* Renamed the plugin to Finspire Creative Role-Based Logo.
* Added a shortcode copy field and button to the admin page.
* Renamed fallback logo wording to default logo.
* Renamed role logo wording to role-based logos.
* Added WordPress.org plugin metadata and readme.txt.

= 1.1.0 =
* Added default width and height settings for the default logo and each role-based logo.
* Preserved shortcode width and height overrides.

= 1.0.0 =
* Initial release.
