/* -------------------------------------------------------------
   VOIDSPIDER - URL‑Logger für Hubzilla – mit KLICK‑Counter & Ausschluss-Prüfung
   2026 by 𝖜𝖆𝖗𝖟𝖆𝖟𝖊𝖑⛧ - www.voidofxulub.com @license MIT
   Wiki: https://voidofxulub.com/wiki/warzazel
   ------------------------------------------------------------- */

#### INSTALLATION ####

Als allererstes muss man eine Datenbank anlegen 

    Öffne phpMyAdmin
    Wähle deine Datenbank aus (oder erstelle eine neue)
    Klicke auf den Tab "SQL"
    Kopiere den Code unten
    Füge ihn ein und klicke auf "Ausführen"
    
#### SQL-Code für die Tabellen ####
    
-- Tabelle für Ausschluss-Einträge
CREATE TABLE IF NOT EXISTS `ausschluss` (
  `id` int NOT NULL AUTO_INCREMENT,
  `exclude` varchar(128) COLLATE utf8mb4_general_ci NOT NULL,
  `url` varchar(500) COLLATE utf8mb4_general_ci DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;

-- Tabelle für URL-Hits
CREATE TABLE IF NOT EXISTS `url_hits` (
  `id` int NOT NULL AUTO_INCREMENT,
  `ts` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `url` varchar(255) COLLATE utf8mb4_general_ci NOT NULL,
  `hitcount` int NOT NULL DEFAULT '1',
  `own_slugs` varchar(255) COLLATE utf8mb4_general_ci DEFAULT NULL,
  UNIQUE KEY `id` (`id`, `ts`, `url`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;

#### Datenbankverbindung anpassen ####

In den Dateien "url_logger.txt" und "voidspider.txt" die Datenbankverbindung anpassen,
also Username, Datenbankname und Passwort.

#### Code in Hubzilla für den Kanal erlauben #### 

Dann muss man für seinen Kanal "Code erlauben" aktivieren. 
Das macht man in "Administration - Kanäle", klickt die "< >" an und 
klickt auf "Code erlauben/Code sperren"

#### Hubzilla-"Webseiten-App" installieren ####

Nun muss die Hubzilla-App "Webseiten" installiert sein. Das macht man
unter "Apps - Verfügbare Apps - Webseiten - Installieren"

#### Hubzilla-Blöcke erstellen ####

Dann geht man auf "Webseiten - Blöcke - Erstelle"
Wichtig ist das bei "Art des Seiteninhalts" "PHP" ausgewählt ist.
Dann vergibt man einen "Block-Name", z.B. "top10" und beim 2. Block "url_logger"

So erstellt man 2 Blöcke und fügt jeweils den Code aus den Dateien "url_logger.txt"
und "voidspider.txt" ein.

#### PDL-Editor/Module einrichten ####
Dann geht man in Hubzilla in den "PDL-Editor" und klickt unten auf "Modules"
Da sucht man für die Artikel den Eintrag "articles". Dann klickt man auf "Items" und 
sucht die eben erstellten Blöcke. Achtung: Hier nur den "url_logger" einfügen und dann
auf "Apply" klicken. Dasselbe macht man noch mit "cards" und "wiki". Der Block "url_logger" ist für die Zählung verantwortlich und nicht sichtbar.

#### VoidSpider anzeigen lassen ####

Ist das erledigt, sucht man noch das Modul "hq" um den eigentlichen
VoidSpider-Klickcounter anzeigen zu lassen. Da dann wieder "Item" und den Block "top10"
einfügen. Warum im HQ? Weil man ihn da nur als Kanal-Besitzer sehen kann, sonst keiner.

/**
 * @license MIT
 * © 2026 by 𝖜𝖆𝖗𝖟𝖆𝖟𝖊𝖑⛧ - Benutzung auf eigene Verantwortung
 */