=== GamiPress - Link ===
Contributors: gamipress, tsunoa, rubengc, eneribs
Tags: link, click, gamipress, gamification, gamify, points, achievements, badges, awards, rewards, credits, engagement
Requires at least: 4.4
Tested up to: 6.9
Stable tag: 1.1.5
License: GNU AGPLv3
License URI:  http://www.gnu.org/licenses/agpl-3.0.html

Add activity events based on link clicks generated by [gamipress_link]

== Description ==

GamiPress - Link let's you add activity triggers filtered by link clicks adding new activity events on [GamiPress](https://wordpress.org/plugins/gamipress/ "GamiPress")!

Note: This add-on is designed to award users for link clicks, if you want to award them for button clicks, then you should check the [GamiPress - Button](https://wordpress.org/plugins/gamipress-button/ "GamiPress - Button") add-on.

https://youtu.be/ram4nUN9bHs

= New Events =

* Click any link: When an user clicks on any link.
* Click a link with a specific URL: When an user clicks on any link with a specific URL.
* Click a link with a specific ID: When an user clicks on any link with a specific identifier (link id attribute).
* Click a link with a specific Class: When an user clicks on any link with a specific class (link class attribute).
* Get a click on any link: When the post/comment author gets clicks on any link.
* Get a click on a link with a specific URL: When the post/comment author gets clicks on any link with a specific URL.
* Get a click on a link with a specific ID: When the post/comment author gets clicks on any link with a specific identifier (link id attribute).
* Get a click on a link with a specific Class: When the post/comment author gets clicks on any link with a specific class (link class attribute).

Important: The unique links that trigger this activities are the links generated by [gamipress_link] shortcode.

== Installation ==

= From WordPress backend =

1. Navigate to Plugins -> Add new.
2. Click the button "Upload Plugin" next to "Add plugins" title.
3. Upload the downloaded zip file and activate it.

= Direct upload =

1. Upload the downloaded zip file into your `wp-content/plugins/` folder.
2. Unzip the uploaded zip file.
3. Navigate to Plugins menu on your WordPress admin area.
4. Activate this plugin.

== Frequently Asked Questions ==

== Screenshots ==

== Frequently Asked Questions ==

= Which attributes support [gamipress_link] shortcode? =

[gamipress_link] shortcode supports:

* href: The link URL.
* label: The link label text.
* id: The link identifier.
* class: The link CSS classes.
* target: The link target attribute.
* title: The link title attribute.

Example: ``[gamipress_link href="https://gamipress.com" label="Click here!" id="my-link" class="awesome-links one-class other-class" target="_blank" title="Click here!"]``

= Can this plugin work with custom elements? =

Yes! GamiPress - Link is looking for elements with the class ``gamipress-link``, you can make it work with a custom element using the following code:


	<div id="{optional-id}" class="gamipress-link {optional-class} {optional-class-2}">Click Here!</div>

If you set an id attribute, triggers limited by specific ID will be triggered too.
Also, if you define more classes to the class attribute, triggers limited by specific class will be triggered too.

== Changelog ==

= 1.1.5 =

* **Bug Fixes**
* Added security to shortcode.

= 1.1.4 =

* **Improvements**
* Added the label attribute on the shortcode generated on the requirements UI.

= 1.1.3 =

* **Bug Fixes**
* Fixed type on the awards engine check.

= 1.1.2 =

* **New Features**
* Added a shortcode section on the requirements UI to better guide about the shortcode required.
* **Improvements**
* Performance improvements by limiting the number of requirements to check to only those who match with the event parameters.

= 1.1.1 =

* **Improvements**
* Make links click don't prevent any default event to let work other plugins.

= 1.1.0 =

* **Improvements**
* Updated plugin security by adding the most up to date WordPress security methods.
* **Developer Notes**
* Old changelog moved to changelog.txt file.