Pomehore Magazín WordPress Plugin v0.5.5

Moderná domovská stránka a magazín pre Pomehore s mapou, článkami a geolokáciou.

✨ Features

• 📰 Latest Stories - Zobrazenie najnovších článkov a miest
• 📍 Geolocation - Hľadanie najbližších miest na základe polohy užívateľa
• 📧 Newsletter - Registrácia na odberateľov notifikácií
• 📊 Statistics - Počet článkov, miest a fotografií
• 🎨 Responsive Design - Optimalizované pre všetky zariadenia

🔧 Installation

Option 1: FTP Upload

1. Stiahni všetky súbory z tohto repozitára
2. Vymaž starý pomehore-magazin folder na FTP
3. Nahraj nový pomehore-magazin folder na:

   /wp-content/plugins/pomehore-magazin/

4. V WordPress admin paneli aktivuj plugin

Option 2: Git Clone

cd /wp-content/plugins/
rm -rf pomehore-magazin
git clone https://github.com/andreizajacek-code/pomehore-magazin-plugin.git pomehore-magazin

📋 Required Files

Plugin bude fungovať iba ak má nasledujúcu štruktúru:

pomehore-magazin/
├── pomehore-magazin.php          (Hlavný plugin file)
├── assets/
│   ├── pomehore-magazin.js       (JavaScript - POVINNÝ!)
│   ├── pomehore-magazin.css      (Štýly - POVINNÝ!)
│   └── placeholder-mountain.svg  (Fallback obrázok)
├── README.md
└── CHANGELOG.md

🎯 Usage

Shortcodes

Pridaj na stranu alebo artikel:

[pomehore_home]
// alebo
[pomehore_magazin]

Obidve shortcody robia to isté - zobrazujú domovskú stranu s článkami.

⚙️ Configuration

Plug-in automaticky deteguje:

• ✅ Post type ph_object (mapy/objekty)
• ✅ Custom fields: ph_lat, ph_lng, ph_mountain, atď.
• ✅ Featured images
• ✅ Post thumbnails

Nic ďalšieho sa nekonfiguruje - je to ready-to-use! 🚀

🔐 Security Features v0.5.5

✅ SQL Injection Protection

• Všetky databázové queries používajú $wpdb->prepare()

✅ XSS Protection

• Všetky výstupy sú správne escapované: esc_html(), esc_url(), esc_attr()
• Background images načítané cez JavaScript (CSP-safe)

✅ CSRF Protection

• Newsletter form používa WordPress nonce: wp_verify_nonce()

✅ Error Handling

• Databázové chyby logovane do debug.log
• Užívatelia nevidia interné detaily

🚨 Fixes in v0.5.5

Opravy z bezpečnostného auditu:

1. ✅ Lepšia validácia GPS súradníc (povolí 0.0)
2. ✅ XSS ochrana cez data-attributes
3. ✅ Externý JavaScript (CSP compliance)
4. ✅ Zdokonalené error logovanie
5. ✅ home_url() namiesto hardkódovaných URL
6. ✅ wp_localize_script() pre dáta
7. ✅ Preloading obrázkov

📱 Browser Support

• ✅ Chrome 90+
• ✅ Firefox 88+
• ✅ Safari 14+
• ✅ Edge 90+
• ⚠️ IE 11 (limited - no geolocation)

📍 Geolocation

Requirements

• HTTPS - Geolocation iba funguje na HTTPS!
• User Permission - Užívateľ musí povoli prístup k polohe

Timeout

• 10 sekúnd čakania na odozvu
• Cache polohy 5 minút (presnosť vs. performance)

📧 Newsletter

Plugin automaticky:

1. Vytvorí tabuľku wp_pomehore_newsletter pri aktivácií
2. Uloží emaila s tokenmi
3. Sleduje status: subscribed, unsubscribed
4. Loguje všetky actions

Database Table

CREATE TABLE wp_pomehore_newsletter (
  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
  email VARCHAR(190) UNIQUE NOT NULL,
  status VARCHAR(30) DEFAULT 'subscribed',
  source VARCHAR(80) DEFAULT 'homepage',
  token VARCHAR(64),
  created_at DATETIME NOT NULL,
  updated_at DATETIME NOT NULL,
  unsubscribed_at DATETIME,
  KEY (status)
);

🐛 Troubleshooting

Obrázky sa nezobrazujú

• ✅ Skontroluj či existuje assets/pomehore-magazin.js
• ✅ Skontroluj prehliadač console na chyby (F12)
• ✅ Vymaž cache

Geolocation nefunguje

• ✅ Musí byť HTTPS!
• ✅ Skontroluj či je geolocation povolený v nastaveniach prehliadača
• ✅ Skontroluj console na chyby

Newsletter email sa neuklada

• ✅ Skontroluj WordPress error.log
• ✅ Skontroluj či je tabuľka vytvorená: wp_pomehore_newsletter
• ✅ Skontroluj nonce v HTML (wp_create_nonce)

📞 Support

Pre problémy, otázky alebo návrhy:

• 📧 kontakt@pomehore.sk
• 🐛 GitHub Issues: pomehore-magazin-plugin/issues

📄 License

GPL v2 or later

🙏 Credits

• Pomehore team
• WordPress community
• Haversine formula calculation