Migrimi nga WordPress në Next.js: udhëzues hap pas hapi 2026

WordPress ende fuqizon 43% të webit botëror në 2026, por kufijtë e tij shfaqen shpejt: performancë mediokre out-of-the-box (TTFB tipik 600-1500ms), sipërfaqe e madhe sulmi (43% e hakimeve të webit synojnë WordPress sipas Sucuri 2024), varësi nga plugin-at, kosto të fshehura në përditësime. Për shumë SME që ndjekim te OptionWeb, pyetja nuk është më 'a duhet të migrojmë?' por 'si të migrojmë pa thyer SEO-në?'. Ja playbook-u i plotë i aplikuar në mbi 30 migrime.

1. Pse të migrosh (dhe kur jo)

Migrimi ka kuptim në 4 raste: performancë kritike për biznesin (e-commerce, lead gen agresiv), ridizajnim i madh tashmë i parashikuar, ekip teknik që do të dalë nga legacy plugin hell, ose nevojë për shkallëzim ndërkombëtar (i18n nativ i Next.js mund WPML/Polylang).

Mos migro nëse: ekip redaktues jo-teknik pa alternativë CMS, buxhet < 10 000 €, ridizajnim vetëm për 'të qenë modern' (arsyeja e vërtetë e padukshme), ose faqe me >100 plugin kritikë pa ekuivalent Next.js.

2. Auditim paraprak i faqes WordPress

Auditi është hapi më i lënë pas dore dhe më kritik. Ta kapërcesh këtë fazë = humbje e garantuar SEO dhe bug-e në produksion.

Mjete për auditin e plotë:

• Screaming Frog SEO Spider — Crawl i të gjitha URL-ve (falas deri në 500 URL, 159 £/vit më sipër). Eksport CSV i URL-ve, status codes, meta tags, H1, lidhjeve të brendshme.
• Google Search Console — Eksport i 1000 query-ve më performues + faqeve të aterrimit. Identifikon URL-të që duhen ruajtur patjetër.
• Wayback Machine — Snapshot historik i faqes si referencë për dizajn dhe përmbajtje.
• WordPress phpMyAdmin — Inventar i custom post types, meta fields, taksonomive, komenteve.
• Google Analytics 4 — Top 50 faqet sipas sesioneve, sjelljes së përdoruesit, bounce rate. Këto faqe duhet patjetër të punojnë pas migrimit.

Dorëzime të auditit: tabelë Excel me të gjitha URL-të (të vjetra + të reja), listë e plugin-ave kritikë me alternativa Next.js, inventar i mediave (madhësi totale, formate), listë e integrimeve të jashtme (pagesë, CRM, mailing, chat), skicë e strukturës së re të URL-ve.

3. Eksporti i përmbajtjes

Tre metoda sipas vëllimit dhe kompleksitetit:

Te OptionWeb kombinojmë WP REST API (përmbajtje e strukturuar) + një script Node.js për shkarkim paralel të mediave. Artikujt konvertohen në MDX ose JSON sipas arkitekturës objektiv. Llogarit 1-2 ditë për 500 artikuj.

import fs from 'node:fs/promises';
import path from 'node:path';

const WP_API = 'https://votre-site.com/wp-json/wp/v2';

async function fetchAllPosts() {
  const allPosts = [];
  let page = 1;
  while (true) {
    const res = await fetch(`${WP_API}/posts?per_page=100&page=${page}&_embed`);
    if (!res.ok) break;
    const posts = await res.json();
    if (posts.length === 0) break;
    allPosts.push(...posts);
    page++;
  }
  return allPosts;
}

const posts = await fetchAllPosts();
await fs.writeFile('content/posts.json', JSON.stringify(posts, null, 2));

4. Arkitektura Next.js si objektiv

Rekomandimi 2026 për migrimin WordPress → Next.js: App Router + static export. Përparësi: vendosje në çdo server (pa Node.js), TTFB në milisekonda, imun ndaj dobësive të WordPress, shkallëzim i pafundmë.

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'export',
  images: { unoptimized: true },
  trailingSlash: true,
  i18n: undefined, // gérer via app/[lang]/ pour static export
};
export default nextConfig;

Strukturë dosjesh e rekomanduar:

• app/[lang]/ — Rrugë shumëgjuhëshe, page.tsx, [slug]/page.tsx, blog/page.tsx, blog/[slug]/page.tsx
• content/ — JSON ose MDX të përmbajtjes së migruar, me schema Zod për validim në build
• components/ — Komponentë React (zëvendësojnë blloqet Gutenberg)
• public/ — Media të migruara nga wp-content/uploads/
• lib/ — Mjete (markdown në React, harta hreflang etj.)

5. Ridizajnimi i UI dhe komponentët

Gabimi #1: të përpiqesh të klonosh temën WordPress pixel-perfect. E gjatë, e mërzitshme dhe humbet rastin.

Qasja e rekomanduar: nis nga wireframet e çdo lloji faqeje (homepage, faqe shërbimi, artikull blogu, kontakt etj.), ridizajno me komponentë Tailwind ose design system custom (shadcn/ui, Radix Themes), shto animacione moderne (Framer Motion), kalo në mobile-first.

6. Redirektimet 301 (ruajtja e SEO)

Pika më kritike e çdo migrimi. Një URL e rëndësishme e redirektuar gabim = humbje pozicionesh në Google. Procedurë rigoroze:

1. Listo të gjitha URL-të WordPress (Screaming Frog ose Google Analytics)
2. Rendit sipas trafikut organik 12-mujor (fokus në top 80% të trafikut)
3. Mapo çdo URL të vjetër në URL-në e re Next.js
4. Konfiguro 301-shet në .htaccess (Apache) ose rewrites Next.js + Cloudflare
5. Testo çdo mapim me curl -I ose Screaming Frog në mënyrën redirect-check
6. Dorëzo sitemap-in e ri te Search Console në ditën e go-live
7. Monitoro 404-shet në Search Console për 4-6 javë, shto redirektimet që mungojnë

RewriteEngine On

# Redirections 301 anciennes URLs WordPress
Redirect 301 /?p=123 /fr/article-titre-canonique/
Redirect 301 /category/seo /fr/blog/?cat=seo
Redirect 301 /author/admin /fr/equipe/

# Pattern WordPress permalinks date-based
RewriteRule ^([0-9]{4})/([0-9]{2})/([0-9]{2})/([^/]+)/?$ /fr/blog/$4/ [R=301,L]

7. Vendosja dhe validimi

Plan tipik vendosjeje:

Fitime të matura pas migrimit

Metrika tipike të vërejtura në mbi 30 migrime OptionWeb (faqe SME 50-500 faqe):

• TTFB — WordPress 600-1500ms → Next.js static 30-80ms (e ndarë në 10)
• Lighthouse Performance — WordPress 45-65 → Next.js 95-100 në mobile
• Lighthouse SEO — WordPress 85 (shpesh) → Next.js 100/100 në mënyrë sistematike
• Kosto hosting — WordPress i përbashkët 15 €/muaj → static export në CDN 5-10 €/muaj (Cloudflare Pages, Vercel free, Netlify free)
• Dobësi sigurie — Sipërfaqe sulmi e ndarë në ~50 (pa admin WP, pa DB, pa ekzekutim PHP)
• Trafik organik — +10 deri +30% në 3-6 muaj falë fitimeve CWV (sinjale rangimi Google)