Cookie Banner Integration for Neokred

The Cookie Banner Integration for Neokred plugin automatically adds cookie consent and management scripts to your WordPress website. It provides an easy-to-use admin interface for managing your cookie compliance without requiring any coding knowledge.

This plugin integrates with the Neokred cookie management service to display cookie consent banners and manage user preferences in compliance with GDPR, CCPA, and other privacy regulations.

Features

• Easy Integration: Simply enter your Domain ID from Neokred dashboard
• Admin Dashboard: User-friendly settings page in WordPress admin
• DPDP Ready: Helps ensure compliance with privacy regulations
• Local File Loading: Scripts are included locally in the plugin for better performance and security
• Automatic Loading: Scripts are loaded properly using WordPress standards
• Visual Status: See if your integration is active or needs configuration
• Settings Link: Quick access to settings directly from the plugins page
• Secure: Implements nonces, capability checks, and proper escaping
• Debug Mode: Built-in debugging for administrators to troubleshoot issues
• File Validation: Automatic checks to ensure SDK file is present
• Cache Busting: Automatic version control for script updates
• Async Loading: Optimized script loading for better performance

How It Works

1. Sign up for a Neokred cookie management account
2. Get your unique Domain ID from the Neokred dashboard
3. Enter the Domain ID in the plugin settings
4. Click “Save Changes”
5. The cookie banner appears automatically on your website

The plugin uses WordPress best practices to properly enqueue the Neokred banner SDK script from local files, ensuring optimal performance and security.

Third-Party Service Notice

This plugin connects to the Neokred cookie management service. When you use this plugin:
– The banner SDK script is loaded locally from the plugin files
– User consent choices may be transmitted to Neokred servers for management
– The service may store cookies to remember user preferences

By using this plugin, you acknowledge that you have reviewed and agree to:
– Neokred’s terms of service
– Neokred’s privacy policy
– The use of this third-party service on your website

No user data is sent to third parties without explicit consent action by the website visitor.

Configuration

After activation:

1. Go to Settings > Cookie Banner in your WordPress admin
2. Enter your Domain ID (get this from your Neokred dashboard)
3. Click “Save Changes”
4. Check the “Integration Status” section to verify the SDK file is found

Example Domain ID format:
add7342a-d335-407f-a570-01eafdcd1c19

Note: You must have a Neokred account to get your Domain ID. Visit neokred.tech to sign up.

Privacy Policy

This plugin integrates with the Neokred cookie management service, which is a third-party service.

What This Plugin Does:
– Loads the Neokred banner SDK locally from the plugin directory
– Stores your Domain ID in your WordPress database
– Does not collect any user data itself
– Does not make external calls except for Neokred service functionality

What the Neokred Service Does:
– Displays cookie consent banners to your website visitors
– May store cookies to remember user consent preferences
– May transmit consent choices to Neokred servers
– Collects data according to Neokred’s privacy policy

Your Responsibilities:
– Review Neokred’s privacy policy and terms of service
– Ensure your use complies with applicable privacy laws (GDPR, CCPA, etc.)
– Configure your Neokred settings appropriately for your jurisdiction
– Update your website’s privacy policy to mention the use of this service

For more information about how Neokred handles data, please visit their website and review their privacy documentation.

Support

For plugin-related questions:
– Review the FAQ section above
– Check the detailed instructions in Settings > Cookie Banner
– Use the built-in debug mode (visible to administrators in page source)
– Check the troubleshooting section in the admin dashboard

For Neokred service support:
– Visit the Neokred website
– Contact Neokred support through their official channels

External Services

This plugin relies on the following external service:

Neokred Cookie Management Service
– Purpose: Provides cookie consent banner and preference management
– Data Handling: User consent preferences may be transmitted and stored
– Required: Yes, a Neokred account is required to use this plugin

The banner SDK is included locally in the plugin and does not require external CDN services.

By using this plugin, you acknowledge and agree to the use of the Neokred service.

Troubleshooting

Script Not Loading

1. Check Settings > Cookie Banner in your WordPress admin
2. Verify the “SDK File Status” shows “✓ Found”
3. If file is missing, re-upload the plugin with the complete assets folder
4. View your website’s page source and look for debug comments at the bottom
5. Check browser console (F12) for JavaScript errors

File Permission Issues

Ensure proper file permissions:
– Folders: 755
– Files: 644

WordPress.com Staging Issues

WordPress.com staging sites have additional security restrictions. The debug mode will help identify specific issues. Contact WordPress.com support if security policies are blocking the script.

Cache Issues

Clear your cache after:
– Installing or updating the plugin
– Changing the Domain ID
– Updating the banner-sdk.js file

Compatible caching plugins will automatically handle cache invalidation due to version control.

License

This plugin is licensed under the GPLv2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Automatic Installation

1. Log in to your WordPress admin dashboard
2. Navigate to Plugins > Add New
3. Search for “Cookie Banner Integration for Neokred”
4. Click “Install Now” and then “Activate”

Manual Installation

1. Download the plugin files
2. Upload the neokred-blutic-cookie-integration folder to your /wp-content/plugins/ directory
3. Ensure the assets/js/banner-sdk.js file is included in the upload
4. Log in to your WordPress admin dashboard
5. Navigate to Plugins > Installed Plugins
6. Find “Cookie Banner Integration for Neokred” and click “Activate”

1.0.3

• Enhancement: Added file existence validation before enqueueing script
• Enhancement: Added comprehensive troubleshooting section in admin dashboard
• Enhancement: Added debug mode for administrators (shows diagnostic info in page source)
• Enhancement: Added SDK file status indicator in admin interface
• Enhancement: Added cache busting using file modification time
• Enhancement: Added async attribute to script tag for better performance
• Enhancement: Display file path, size, and modification date in troubleshooting section
• Enhancement: Shows whether script was successfully enqueued
• Fix: Graceful error handling when banner-sdk.js is missing
• Fix: Better compatibility with WordPress.com staging environments
• Security: Debug info only visible to administrators
• UX: Clear error messages when SDK file is missing
• UX: Visual indicators for file status (found/missing)

1.0.2

• Fix: Removed remote file loading – banner-sdk.js now included locally in plugin
• Fix: Fixed nonce sanitization using sanitize_text_field() and wp_unslash()
• Fix: Added wp_unslash() to domain_id input sanitization
• Fix: Properly escaped all output including placeholder text
• Fix: Changed to wp_register_script() and wp_enqueue_script() for proper script registration
• Fix: Reduced tags to 5 in readme.txt as per WordPress guidelines
• Security: Enhanced security by loading all resources locally
• Enhancement: Removed SDK version field – no longer needed with local files
• Enhancement: Simplified configuration and maintenance
• Performance: Improved loading speed by eliminating external CDN dependency
• Compliance: Fully compliant with WordPress.org plugin repository guidelines

1.0.1

• Security: Added nonce verification for form submissions
• Security: Added capability checks using current_user_can()
• Security: Implemented proper output escaping for all variables
• Security: Added input sanitization for all form fields
• Enhancement: Changed to use wp_enqueue_script() instead of raw script tags
• Enhancement: Simplified configuration – now only requires Domain ID instead of full script tag
• Enhancement: Added visual status indicator (Active/Not Configured)
• Enhancement: Added internationalization support with text domain
• Enhancement: Improved admin interface with clearer instructions
• Enhancement: Added constants for plugin version and paths
• Enhancement: Better function naming with proper prefixing
• Fix: Updated plugin name to “Cookie Banner Integration for Neokred” to avoid trademark confusion
• Fix: Updated Plugin URI to production URL
• Fix: Added proper contributors list including plugin author
• Fix: Updated minimum PHP requirement to 7.0
• Fix: Added comprehensive third-party service disclosure
• Compatibility: Tested up to WordPress 6.8

1.0

• Initial release
• Basic script integration functionality
• Admin settings page
• Default script configuration for quick setup