Kama Click Counter

With this plugin, you can gather statistics on clicks for file downloads or any other link across the site.

To insert a file download block, use the [download url="any file URL"] shortcode.

The plugin does not include additional tools for uploading files. All files must be uploaded using the standard WordPress media uploader. The URLs are then used to create the download block.

Additionally, the plugin includes:

• A button in the visual editor for quickly inserting the file download block shortcode.
• A customizable widget that allows you to display a list of “Top Downloads” or “Top Link Clicks.”

1. 

   Statistics page.

2. 

   Plugin settings page.

3. 

   Single link edit page.

4. 

   TinyMCE visual editor downloads button.

4.1.1

• FIX: Minor bugfix on options update.

4.1.0

• NEW: clicks_in_month, clicks_prev_month DB fields added. Now the plugin tracks clicks per month.
• NEW: Unit tests infrastructure added and some code covered with unit tests.
• FIX: Possible XSS protection: escapes and sanitizations added for widget as well.
• CHG: Referer check logic removed because of incorrect working.
• IMP: modify_links in content minor performance improvements.
• IMP: Download Template separeted from HTML and now added in HEAD.
• IMP: Link_Item Object added.
• IMP: idna_convert.php phpstan fixes.
• IMP: Some jQuery deps removed. NPM packages updated.
• IMP: Other improvements & bugfixes.
• IMP: Upgrader logic improved.
• IMP: Multisite support for Uninstall.

4.0.4

• IMP: To make it harder to add any links to the DB via a simple GET request, added additional check that the referer matches the current site. Thanks to Carmine Cappetti.
• IMP: Minor improvements.

4.0.3

• FIX: Bugfix the counter not worked after the last updates for the count click of Download block. And more.
• IMP: Minor improvements.

4.0.2

• CHG: Min PHP version 7.0 >> 7.1.
• FIX: Plugin init moved to after_setup_theme hook to avoid some conflicts.
• IMP: minor improvements.
• UPD: Tested up to: WP 6.8.0

4.0.1

• FIX: Bug in counter.js script.

4.0.0

• CHG: Requires PHP >= 7.0.
• DEL: Removed backcompat code.
• IMP: Code refactored.
• ADD: PHP class autoloader.
• ADD: PHP namespaces.
• CHG: Filter kcc_admin_access renamed to kcc_manage_access.
• CHG: Filter parce_kcc_url renamed to click_counter__parse_kcc_url.
• CHG: Filter get_url_icon renamed to click_counter__get_icon_url.

3.6.10

• IMP: Minor improvements.

3.6.9

• IMP: Performance improvements; no jQuery dependency for base count JS.

3.6.8.2

• FIX: Bug in previous version.

3.6.8.1

• FIX: Protocol for external links issue (leaving //).
• FIX: Compatibility with PHP 7.4.

3.6.8

• FIX: Wrong URL count with query parameters.
• FIX: Bug in widget loop.
• FIX: Other minor fixes.

3.6.7.3

• FIX: <title> parsing issue.

3.6.7

• FIX: Wrong counting with “hide link under id” option enabled.
• FIX: Minor code fixes.

3.6.6

• FIX: access_role option not saved.
• ADD: desc attribute to shortcode.

3.6.5

• FIX: Filesize parsing issue due to missing HTTP protocol.

3.6.4.2

• CHG: Minor changes to download block HTML markup and CSS styles.

3.6.4

• ADD: urldecode for incoming URLs when saving to DB. Thanks to Mark Carson.
• NEW: Exclude URL counting filter added (see options page).

3.6.3

• FIX: esc_url() for wp_redirect() to avoid spaces deletion. Thanks to Mark Carson.

3.6.2

• ADD: in_post field on edit link admin page to change associated post ID.
• ADD: Sanitize data on edit link POST request.
• NEW: Save URLs without protocol (//site.ru/foo).
• FIX: Admin list search starting from pagination page.
• FIX: Detection of URLs without protocol.
• FIX: Title detection for protocol-less URLs using WP HTTP API.
• FIX: Minor bug fixes.

3.6.1

• ADD: title attribute for [download] shortcode.
• ADD: Improved TinyMCE button modal window (browse media library).
• FIX: Count clicks from mouse wheel and context menu.

3.6.0

• CHG: Class name KCClick changed to KCCounter.
• CHG: Icon in TinyMCE visual editor updated.

3.5.1

• CHG: Move localization to translate.wordpress.org.
• FIX: Minor code fix.

3.5.0

• FIX: XSS vulnerability fixed.
• CHG: Class name KCC changed to KCClick.
• CHG: Translate PHP code to English (Russian moved to localization file).

3.4.9

• FIX: Remove admin-bar link for roles without plugin access.

3.4.8

• ADD: “Clicks per day” data on edit link screen.

3.4.7 – 3.4.7.3

• FIX: Table structure to support utf8mb4_unicode_ci charset.

3.4.6

• ADD: get_url_icon filter to manage icons.

3.4.5

• ADD: Administrator option to assign plugin access to other WP roles.
• ADD: Option to add KCC Stats link to admin bar.
• DEL: Removed HTTP_REFERER block on direct KCC URL use.

3.4.4

• CHG: is_file extension check method for URL.
• ADD: kcc_is_file filter.
• ADD: Widget option to set link to post instead of file.
• DEL: Removed kcc_file_ext filter.

3.4.3

• ADD: Hooks parce_kcc_url, kcc_count_before, kcc_count_after.
• ADD: Second parameter $args to kcc_insert_link_data filter.
• ADD: Punycode support for link filtering.
• FIX: Count clicks from mouse wheel, touch, and ctrl+click.

3.4.2

• ADD: kcc_admin_access filter to change access capability.
• FIX: Redirect protection fix.

3.4.1

• FIX: KCC URL parsing issue.

3.4.0

• ADD: Option to hide URL in download block.
• ADD: link_url column index in DB for performance.
• ADD: Hooks get_kcc_url, kcc_redefine_redirect, kcc_file_ext, kcc_insert_link_data.
• ADD: Replace ugly URL with original URL on hover.
• ADD: Replace “edit link” text in download block with icon.
• FIX: Duplicate URL updates (e.g., containing % symbol).
• FIX: XSS protection added.
• FIX: Code structure fixes.

3.3.2

• FIX: PHP notice.

3.3.1

• ADD: de_DE localization. Thanks to Volker Typke.

3.3.0

• ADD: Localization on plugin page.
• ADD: Menu to admin page.
• FIX: Antivirus false positive detection.

3.2.34

• FIX: Admin CSS changes.

3.2.3.3

• ADD: jQuery links now hidden with #kcc anchor and onclick attribute.
• FIX: parse_url bug when URL contained “=” character.

3.2.3.2

• FIX: Redirect to URL with space (" ") character.
• ADD: Round “clicks per day” value to one decimal on admin stats page.

3.2.3.1

• FIX: “Back to stat” link on “edit link” admin page.

3.2.3

• FIX: Redirects to HTTPS were not working correctly.
• FIX: PHP < 5.3 support.
• FIX: “Go back” button on “edit link” admin page.
• FIX: Localization issues.

3.2.2

• ADD: “Go back” button on “edit link” admin page.

3.2.1

• CHG: Auto-replace old shortcodes [download=""] with [download url=""] in DB during update.

3.2

• ADD: Widget feature.