=== Karma Protected Content ===
Contributors: ermannaro
Tags: content protection, shortcode, registered users, membership, content restriction
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Protect parts of your post content with a simple shortcode, visible only to registered users.

== Description ==

This plugin is a minimal, lightweight solution that lets you protect specific parts of your WordPress post content, making them visible only to registered users.

Visitors who are not logged in will see a customizable colored banner with a button that links to the registration page.

= Main features: =

* Simple shortcode: `[contenuto_protetto]`
* Customizable banner for non-registered users
* Default messages configurable in settings
* Custom link for the registration page
* Meta box in the editor sidebar with usage instructions
* Responsive, modern design
* Lightweight and performant

= How it works: =

1. Wrap the content you want to protect with the `[contenuto_protetto]` shortcode
2. Registered users will see the content as usual
3. Non-registered visitors will see a banner with a registration button

= Customization: =

You can customize:
* Banner title
* Banner text
* Banner background color
* Button text
* Registration page link

All settings are available under **Settings > Protected Content**.

= Usage examples: =

**Basic example:**
```
[contenuto_protetto]
This text is for registered users only.
[/contenuto_protetto]
```

**With custom options:**
```
[contenuto_protetto titolo="Premium Content" testo="Register to read" colore="#ff0000"]
Protected content here
[/contenuto_protetto]
```

== Installation ==

= Automatic installation: =

1. Go to **Plugins > Add New** in the WordPress dashboard
2. Search for "Karma Protected Content"
3. Click **Install Now** and then **Activate**

= Manual installation: =

1. Download the plugin
2. Upload the `karma-contenuto-protetto` folder to `/wp-content/plugins/`
3. Activate the plugin from the **Plugins** screen in WordPress

== Frequently Asked Questions ==

= How do I use the shortcode? =

Wrap the content you want to protect with `[contenuto_protetto]`. Make sure to use the "Code" mode in the WordPress editor, not the "Visual" mode.

= Can I customize the banner messages? =

Yes! Go to **Settings > Protected Content** to configure the default messages. You can also customize each shortcode individually using the attributes.

= What attributes can I use in the shortcode? =

Use these attribute names (they are required by the plugin) in your shortcode:
* Banner title — use attribute `titolo`
* Banner text — use attribute `testo`
* Background color in hexadecimal (e.g. #0073aa) — use attribute `colore`
* Button text — use attribute `pulsante`

= Can I use a custom link for registration? =

Yes, in the settings you can enter an absolute or relative URL for the registration page.

== Screenshots ==

1. Banner for non-registered users
2. Meta box with instructions in the editor
3. Settings page

== Changelog ==

= 1.0.1 =
* Readme translated to English for WordPress.org compliance.

= 1.0.0 =
* Initial release
* Shortcode to protect content
* Customizable banner for non-registered users
* Settings page
* Meta box with instructions in the editor
* Custom registration link support

== Upgrade Notice ==

= 1.0.1 =
Readme translated to standard English for WordPress.org.

= 1.0.0 =
Initial release of the plugin.