SEO Redirect

Automatikus 404-figyelő és 301-es átirányító bővítmény OpenCart 3.0.x áruházakhoz – admin UI nélkül, nulla core módosítással.

Mi ez a bővítmény?

Az SEO Redirect bővítmény két problémát old meg egyszerre: automatikusan naplózza a 404-es (nem található) hibákat, és lehetővé teszi, hogy ezekhez manuálisan 301-es átirányításokat rendelj phpMyAdmin-ban – anélkül, hogy bármilyen core fájlhoz hozzányúlnál.

A bővítmény az OpenCart natív Event rendszerét használja, így teljes mértékben kompatibilis az áruház jövőbeli frissítéseivel, és egyetlen meglévő fájlt sem módosít.

Funkciók

Követelmények

Fájlstruktúra

A bővítmény pontosan 4 fájlból áll. Mindegyik új fájl – egyiket sem írja felül.

opencart_root/
├── admin/
│   ├── controller/extension/module/
│   │   └── seo_redirect.php   ← install / uninstall / index
│   └── language/en-gb/extension/module/
│       └── seo_redirect.php   ← language strings
└── catalog/
    ├── controller/extension/module/
    │   └── seo_redirect.php   ← catch404 event handler
    └── model/extension/module/
        └── seo_redirect.php   ← DB műveletek

Telepítési lépések

Eltávolítás

Az Uninstall gomb csak az event hook regisztrációját törli. Az oc_seo_redirect tábla és a benne lévő adatok megmaradnak – szándékosan.

Manuális telepítés / eltávolítás (ha az Install gomb nem működik)

Ha az admin Install gomb hibát dob, a telepítés elvégezhető közvetlenül phpMyAdmin-ban:

-- Telepítés (mind a három sor szükséges)
CREATE TABLE IF NOT EXISTS `oc_seo_redirect` (
  `from`       VARCHAR(255) NOT NULL,
  `to`         VARCHAR(255) DEFAULT NULL,
  `hits`       INT UNSIGNED NOT NULL DEFAULT 1,
  `created`    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated`    DATETIME DEFAULT NULL,
  `last_ip`    VARCHAR(45) DEFAULT NULL,
  `user_agent` VARCHAR(255) DEFAULT NULL,
  `referer`    VARCHAR(255) DEFAULT NULL,
  PRIMARY KEY (`from`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

INSERT INTO `oc_event` (`code`, `trigger`, `action`, `status`, `sort_order`)
VALUES ('seo_redirect', 'catalog/controller/error/not_found/before', 'extension/module/seo_redirect/catch404', 1, 0);

INSERT INTO `oc_extension` (`type`, `code`) VALUES ('module', 'seo_redirect');

-- Eltávolítás
DELETE FROM `oc_event`     WHERE `code` = 'seo_redirect';
DELETE FROM `oc_extension` WHERE `code` = 'seo_redirect';

Tábla struktúra

CREATE TABLE IF NOT EXISTS `oc_seo_redirect` (
  `from`       VARCHAR(255) NOT NULL,
  `to`         VARCHAR(255) DEFAULT NULL,
  `hits`       INT UNSIGNED NOT NULL DEFAULT 1,
  `created`    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated`    DATETIME DEFAULT NULL,
  `last_ip`    VARCHAR(45) DEFAULT NULL,
  `user_agent` VARCHAR(255) DEFAULT NULL,
  `referer`    VARCHAR(255) DEFAULT NULL,
  PRIMARY KEY (`from`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

SQL lekérdezések

Kezelendő redirectek fontossági sorrendben

SELECT `from`, `hits`, `created`, `referer`
FROM `oc_seo_redirect`
WHERE `to` IS NULL
ORDER BY `hits` DESC;

Redirect hozzárendelése egy URL-hez

UPDATE `oc_seo_redirect`
SET `to` = '/uj-termek-url', `updated` = NOW()
WHERE `from` = '/regi-termek-url';

Már kezelt redirectek listája

SELECT `from`, `to`, `hits`, `updated`
FROM `oc_seo_redirect`
WHERE `to` IS NOT NULL
ORDER BY `hits` DESC;

Gyanús / bot bejegyzések törlése

DELETE FROM `oc_seo_redirect`
WHERE `from`       LIKE '%wp-%'
   OR `from`       LIKE '%.env%'
   OR `from`       LIKE '%.php%'
   OR `user_agent` LIKE '%bot%';

Top 10 legtöbbet keresett hiányzó oldal (utolsó 30 nap)

SELECT `from`, `hits`, `created`
FROM `oc_seo_redirect`
WHERE `to` IS NULL
  AND `created` >= DATE_SUB(NOW(), INTERVAL 30 DAY)
ORDER BY `hits` DESC
LIMIT 10;

Redirect eltávolítása (pl. ha az oldal visszaállt)

UPDATE `oc_seo_redirect`
SET `to` = NULL, `updated` = NULL
WHERE `from` = '/visszaallitott-oldal';

Folyamatábra – catch404 logika

Bot szűrés

A szűrés mind a User-Agent fejlécre, mind az URI-ra vonatkozik. Ha bármelyik tartalmaz egy ismert szignatúrát, a bővítmény azonnal visszatér és nem ment semmit.

Best Practices – Ajánlások

Rendszeres áttekintés

Hetente nézd meg a kezeletlen bejegyzéseket (to IS NULL), és rendeld hozzá a céloldalakat a legtöbb hits értékkel rendelkezőkhöz. Ez közvetlenül javítja a SEO-t és csökkenti a visszafordulási arányt.

Redirect target formátuma

A to mezőbe írj:

• Relatív URL-t ugyanazon a domainen belüli célhoz: /uj-termek-nev
• Abszolút URL-t külső oldalra vagy aldomain célhoz: https://masik-oldal.hu/termek

Ne redirectelj 404-re

Mielőtt kitöltöd a to mezőt, ellenőrizd, hogy a céloldal tényleg létezik és betölt. Egy 301 → 404 lánc ront a SEO értéken.

Adatbázis karbantartás

Havi rendszerességgel töröld a már kezelt, régi bejegyzéseket, ahol a hits alacsony és az oldal már nem releváns. Az oc_seo_redirect tábla nem nő korlátlanul, mert a PRIMARY KEY megakadályozza a duplikátumokat.

Biztonsági szkennelések

A bot szűrő leveszi a terhet, de időnként érdemes futtatni a gyanús bejegyzések törlése SQL-t, hogy a tábla tiszta maradjon.

Tömeg-redirect importálás

Ha egyszerre sok régi URL-hez szeretnél redirectet felvinni (pl. platfomváltás után), használj CSV importot phpMyAdmin-ban, vagy egy egyszeri INSERT ... ON DUPLICATE KEY UPDATE szkriptet:

INSERT INTO `oc_seo_redirect` (`from`, `to`, `updated`)
VALUES
  ('/regi-url-1', '/uj-url-1', NOW()),
  ('/regi-url-2', '/uj-url-2', NOW())
ON DUPLICATE KEY UPDATE
  `to`      = VALUES(`to`),
  `updated` = VALUES(`updated`);

Hibaelhárítás