WP Manifestindependent plugin directory
manifest / content / page-annotator

Page Annotator

Disegna annotazioni SVG a mano libera sopra qualsiasi pagina o post di WordPress. I tratti vengono salvati come post meta e ridisegnati sul frontend come overlay non interattivo, con animazioni di stroke attivate dallo scroll (GSAP ScrollTrigger).

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/salvatorecorsi/page-annotator/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Disegna annotazioni SVG a mano libera sopra qualsiasi pagina o post di WordPress. I tratti vengono salvati come post meta e ridisegnati sul frontend come overlay non interattivo, con animazioni di stroke attivate dallo scroll (GSAP ScrollTrigger).

Cosa fa

  • Editor di disegno che si apre sul frontend del contenuto reale (?annotation=true), caricato dentro un iframe in modalità preview, così disegni esattamente sopra il layout vero.
  • Tratti organizzati in layer, con undo, duplica/sposta/rinomina, selezione ed eliminazione dei singoli path.
  • Immagini (SVG / PNG) caricabili dalla Media Library e posizionabili nell'editor con gizmo stile Figma (sposta, ridimensiona con aspect-lock, ruota). Vivono nei layer accanto ai tratti, ma sul frontend sono statiche e non interattive.
  • Due slot di annotazione (cover e scribbles) e due breakpoint (desktop / mobile), gestiti in modo indipendente.
  • Sul frontend i tratti si animano allo scroll secondo lo stile e il timing scelti nelle impostazioni.
  • Thumbnail virtuale: se un post ha un disegno nello slot cover e nessuna immagine in evidenza, has_post_thumbnail() / get_the_post_thumbnail() restituiscono l'SVG inline.

Come funziona

  • Editor: app React (@wordpress/element) buildata in editor/build, caricata solo con ?annotation=true e permesso edit_posts. Un bottone "Aggiungi annotazioni" nel pannello Gutenberg apre l'editor.
  • Dati: due post meta per ogni post type pubblico — _page_annotator_svg (markup) e _page_annotator_timeline (punti del tratto con startTime/duration per l'animazione).
  • API: namespace REST page-annotator, rotta /annotations/{post_id} (GET/POST). L'SVG salvato è sanitizzato con wp_kses (la whitelist include <path>, <g> e <image>).
  • Immagini: l'upload SVG nella Media Library è abilitato solo per chi ha edit_posts e ogni file SVG è sanitizzato in upload via DOMDocument (includes/svg-upload.php) — rimozione di `