PAP Afiliados Pro

外掛說明

Turn your content into revenue with professional product cards. PAP Afiliados Pro lets you showcase affiliate products with customizable visual templates, automatic marketplace detection, and detailed click statistics — no coding required.

Key Features

  • 5 Card Templates: Standard, Horizontal, Minimal, Comparative and Ranking — choose the best layout for each context
  • Automatic Marketplace Detection: Amazon, Mercado Livre, Shopee, AliExpress and more — detected from the URL
  • 6 Display Shortcodes: Single card, Grid, List, By Category, Recent, and Inline Linker
  • Click Tracking & Statistics: Monitor performance by product, marketplace and time period
  • CSV Import/Export: Manage products in bulk (up to 1,000 rows / 5 MB) with automatic encoding detection
  • Custom Badge System: 7 visual styles (Text, Ribbon, Star, Banner, Medal, Shield, Header Band) with per-preset configuration
  • Privacy First: LGPD compliant — zero personal data storage
  • Gutenberg Integration: Product editor with sidebar panels, PAP Linker block and PAP Link format type
  • Elementor Widget: Native integration with 4 display modes
  • SEO Protected: 7-layer protection against indexing of internal pages

Ideal For

  • Review and comparison blogs
  • Coupon and deal websites
  • Monetized content portals
  • Professional affiliates
  • Content creators

Security and Privacy

  • Privacy compliant (LGPD / data protection)
  • Zero personal data tracking (no IP, no User Agent)
  • Complete input sanitization
  • Protection against SQL Injection, XSS and CSRF

Full Customization

  • 5 card templates with distinct layouts
  • 7 badge styles (SVG inline, no external images)
  • Typography controls: title, price and description font size per preset
  • 19 customizable CSS variables
  • Adjustable colors, borders and spacing
  • Saved presets for reuse

Smart Statistics

  • Dashboard with real-time metrics
  • Interactive charts (local Chart.js)
  • Top clicked products
  • Period filters (7/30/90 days)
  • Data clearing with security rate limit

Performance

  • Object cache across 8 critical classes
  • Conditional loading of scripts and styles
  • Zero external dependencies (no CDN)

Language Support

  • English interface (default)
  • Brazilian Portuguese translation included
  • Translation-ready (full .pot file included)

螢幕擷圖

  • Main dashboard with real-time statistics
  • Template Builder – customize your layout with live preview
  • Product management with filters and search
  • Product card rendered on the frontend
  • Statistics page with interactive charts
  • CSV Import/Export for bulk management
  • Gutenberg Block – PAP Linker in the block editor
  • Help page with documentation and shortcode generator

適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

  • PAP Linker Insert trackable affiliate link.

安裝方式

  1. Upload the pap-afiliados-pro folder to /wp-content/plugins/
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to ‘PAP Afiliados’ in the admin menu
  4. Configure your preferences under ‘Settings’
  5. Create your first product under ‘Add Product’

Requirements

  • WordPress 6.2 or higher
  • PHP 8.2 or higher
  • MySQL 5.7 or higher

常見問題集

Which marketplaces are supported?

Currently detected: Amazon, Mercado Livre, Shopee and AliExpress. The marketplace is automatically identified from the affiliate link URL. You can also use any other affiliate link — it will work with the “Other” marketplace label.

Is the plugin LGPD compliant?

Yes! PAP Afiliados Pro does not store ANY personal data (IP, User Agent, user ID). We only record the product ID, the page URL (path only) and the click timestamp.

Does it work with Gutenberg?

Yes! The product editor uses native Gutenberg sidebar panels for a modern editing experience. We also include a “PAP Linker” block and a “PAP Link” Format Type to add affiliate links directly in the block editor, with integrated product search.

Does it work with Elementor?

Yes! If Elementor is active, a PAP widget is automatically made available with 4 display modes (single, grid, recent, category).

Can I import products in bulk?

Yes! Use the CSV Import/Export feature to manage hundreds of products at once. Each file supports up to 1,000 rows and 5 MB with 8 to 13 columns — including optional fields for rating, pros, cons and ranking data. The plugin automatically detects encoding (UTF-8, Windows-1252, ISO-8859-1) and delimiter (comma or semicolon).

Are the statistics accurate?

Yes! We use JavaScript tracking (sendBeacon API) with fetch fallback, plus 3 anti-spam layers (30-min cookie, 5-sec transient, session counter) to ensure clean and accurate data.

Can I customize the card appearance?

Absolutely! Choose from 5 card templates (Standard, Horizontal, Minimal, Comparative, Ranking), add custom badges with 7 visual styles, and fine-tune typography, colors, borders and spacing in the Template Builder. Save presets to reuse across different pages.

What happens when I uninstall the plugin?

By default, all data is removed (posts, tables, options, transients). If you prefer to keep data for future reinstallation, enable the “Keep data on uninstall” option in Settings before uninstalling.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈PAP Afiliados Pro〉的開發相關工作。

參與者

〈PAP Afiliados Pro〉外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈PAP Afiliados Pro〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

2.5.0

  • New: 5 card templates — Standard, Horizontal, Minimal, Comparative and Ranking with per-shortcode or per-preset selection
  • New: Custom badge system with 7 SVG inline styles (Text, Ribbon, Star, Banner, Medal, Shield, Header Band) and per-preset configuration
  • New: Typography controls in Template Builder — title, price and description font size per preset with optional theme font inheritance
  • New: Rich CSV import supports 5 optional columns (Rating, Pros, Cons, Ranking Position, Ranking Label) — backwards compatible with 8-column format
  • New: Product editor migrated to Gutenberg sidebar panels (Affiliate Details + Card Data) for a modern editing experience
  • New: Product editor mobile-responsive layout with adapted sidebar for smaller viewports
  • New: Template Builder expanded with card template selection, badge configuration and collapsible sections
  • Improved: Template Builder preset preview opens in isolated modal (no longer affects editing state)
  • Improved: Marketplace badge is now clickable with affiliate link and click tracking
  • Improved: Template Builder disables irrelevant controls per template with informative notices
  • Improved: Block API migrated to block.json metadata (WordPress Block API v3)
  • Improved: WordPress 7.0 compatibility — zero deprecation warnings
  • Fixed: Button styles (solid, gradient, outline) now render correctly across all 5 templates
  • Fixed: Card shadow setting properly merged with preset defaults
  • Fixed: Image aspect ratio and fit mode classes applied consistently across all templates
  • Fixed: Minimal template mobile layout maintains horizontal orientation with graceful button wrap
  • Fixed: Statistics charts initialize correctly when switching between Overview and By Post tabs

2.4.1

  • Fixed: Product card buttons not centering properly in grid layout
  • Fixed: Preset import file picker not responding to clicks
  • Added: Review request notice triggered by usage milestones (10 products or 100 clicks)
  • Added: New “By Post” tab in Statistics showing click counts grouped by page URL
  • Improved: Minimum PHP version raised from 7.4 to 8.2
  • Improved: Added runtime PHP version check with graceful deactivation

2.4.0

  • New: Import/Export Hub — reorganized import/export into a tabbed interface (Products, Presets, Statistics)
  • New: Preset Import/Export — export presets to JSON and import them back with conflict resolution (skip, rename, overwrite)
  • New: Statistics CSV Export — export click statistics as CSV with period filter (7/30/90/All days)
  • Improved: Security hardening — added wp_unslash() to stats input, cache invalidation after stats clear, nocache_headers on AJAX responses
  • Improved: Singleton pattern for Linker Stats instance (performance)
  • Fixed: CSV import preview strings were hardcoded in Portuguese instead of using i18n
  • Fixed: Dead condition in CSV process_row simplified

2.3.0

  • Added: Bulk image download during CSV import — opt-out checkbox (enabled by default) downloads remote product images into the Media Library and sets them as Featured Image. Original URL kept as fallback.
  • Added: Size ceiling (10 MB per image), scoped HTTP timeout (20s), and smaller batch size (3 rows/request) when image download is enabled.
  • Added: Replay protection for CSV import batches — rejects duplicate offsets with HTTP 409.
  • Security: RESOURCE-EXISTS hardening in click tracking (AJAX and REST) — verifies product post exists and has expected post_type before writing stats.
  • Security: BULK-LIMIT hardening in product bulk actions — caps processed IDs at 100 per request.

2.2.1

  • Fixed: Default presets not appearing on hosted environments after plugin update (upgrade routine now executes correctly on standard WordPress update path without requiring manual plugin reactivation)
  • Fixed: Products with meli.la URLs remaining labeled as “other” marketplace after detection fix — added versioned marketplace re-scan mechanism that automatically updates all existing products when detection patterns change
  • Improved: Object cache compatibility — added nocache_headers() to dynamic AJAX responses and consistent cache invalidation across all preset write operations for environments with persistent object cache (Redis, Memcached, LiteSpeed)

2.2.0

  • Added: 3 pre-configured presets installed on activation — [PAP] Shopee, [PAP] Mercado Livre, [PAP] Black Friday
  • Added: Empty state with CTA buttons on the product list when no products exist
  • Added: Empty state with shortcode reference link on the statistics page when no clicks are recorded
  • Added: Upgrade routine installs default presets for existing users (one-time, skip if name already exists)
  • Fixed: Marketplace detection now recognizes meli.la shortened URLs for Mercado Livre (from v2.1.2)

2.1.1

  • Improved: Plugin description rewritten for clarity — focus on product cards and visual templates
  • Added: “Settings” action link in plugins list
  • Added: “Support” and “Rate ★” meta links in plugins list
  • Fixed: 4 PHPCS warnings for unused $hook parameter in admin_enqueue_scripts callbacks

2.1.0

  • Added: Shortcode column in presets list with one-click copy
  • Added: Filter/search in shortcode generator dropdowns (5+ options)
  • Added: Product search by name or ID in shortcode generator
  • Added: Marketplace distribution chart in Statistics page
  • Added: Marketplace column in detailed clicks table
  • Improved: Product search endpoint performance (LIKE-based)
  • Improved: Search request handling with abort on new input

2.0.3

  • Fixed: Marketplace badge for “Mercado Livre” displayed without space (“MERCADOLIVRE”)
  • Fixed: Several UI strings were hardcoded in Portuguese instead of English, causing untranslated labels on translate.wordpress.org
  • i18n: Regenerated .pot, updated .po/.mo translation files

2.0.2

  • Added: Preset ID column in Template Builder preset list
  • Added: Shortcodes now accept preset name in addition to numeric ID (e.g., preset_id=”My Theme”)
  • Improved: Preset list migrated to native table layout for better alignment
  • Improved: Zebra striping in preset list for better readability
  • Fixed: Settings page save not working correctly

2.0.1

  • Fixed: Preset system now correctly applies individual visual configurations per shortcode
  • Fixed: Shortcode generator produces correct preset_id parameter
  • Fixed: Click tracking for PAP Link and PAP Linker block works reliably for all users including logged-in administrators
  • Improved: Block API updated to version 3 for WordPress 7.0 compatibility
  • Improved: Template Builder displays visual indicator when editing a preset

2.0.0

  • Complete plugin rewrite (previous version: 1.0.2)
  • Added: Support for Brazilian marketplaces with automatic detection
  • Added: Visual Template Builder with live preview and presets
  • Added: 6 shortcodes (single product, multiple products, category, recent, preset, inline link)
  • Added: CSV Import/Export with encoding and delimiter detection
  • Added: Gutenberg Block (PAP Linker) and Format Type (PAP Link)
  • Added: Elementor Widget with conditional loading
  • Added: Statistics with Chart.js (local copy)
  • Added: Dashboard with real-time metrics
  • Added: REST API for product autocomplete
  • Added: 7-layer SEO protection
  • Added: Full LGPD compliance (zero personal data)
  • Added: Object cache across 8 critical classes
  • Added: Anti-spam with 3 layers (cookie, transient, session)
  • Improved: Architecture with 20 classes (dependency-first)
  • Improved: Security with 7 mandatory rules across all code
  • Improved: Unique prefix papafpro (8 characters) on all elements
  • Improved: Code 100% compliant with WordPress Coding Standards

1.0.2

  • Previous version (discontinued)
  • Basic affiliate features