Vi byggde ett kontaktformulär i en separat .html-fil, skrev ett rapportskript i PHP, och WordPress-redigeraren förstör koden vid varje sparande? En välbekant smärta för alla som går bortom standardblockbyggaren.

Include Me löser den uppgiften med en enda shortcode-rad: den inkluderar en extern HTML/PHP-fil eller innehållet från ett annat inlägg direkt i inläggets brödtext. Pluginet finns i WordPress.org-katalogen med 4 000+ aktiva installationer, betyget 4,8 och uppdateringar för WP 6.9.4. Skaparen, Stefano Lissa, är upphovsmannen bakom Newsletter och Hyper Cache.

Här följer en komplett genomgång: från installation till att skicka variabler till PHP-skript och säkert iframe-läge.

💡 Snabb översikt:

• Installera Include Me från WordPress.org-katalogen (Plugins → Lägg till nytt, sök efter "Include Me").
• Ladda upp din HTML/PHP-fil till mappen /wp-content/include-me/ på servern.
• Infoga shortcoden [includeme file="your-file.html"] där du behöver den i ett inlägg eller en sida.
• För PHP-filer: pluginet kör skriptet och matar ut resultatet. För HTML infogas det som det är.
• Alternativt kan du inkludera ett annat WordPress-inlägg via post_id eller en extern URL via iframe-syntax.

Vad är Include Me och när behöver du det

Include Me är ett lättviktigt plugin (bara några rader kod, enligt skaparen) som löser en specifik uppgift: att infoga en extern fil i brödtexten på ett WordPress-inlägg eller en sida via shortcode.

När du behöver detta i praktiken:

• Formulär och kalkylatorer. Du har skrivit ett HTML-formulär med CSS och JS, och blockredigeraren förstör koden varje gång du växlar mellan visuellt läge och textläge. Include Me infogar filen byte för byte, utan att röra något.
• PHP-rapporter. Ett skript hämtar data från databasen, bygger en tabell och matar ut HTML. Include Me kör PHP-koden och visar resultatet inuti inlägget utan att redigera temat.
• Delade block. Samma fil (pristabell, ansvarsfriskrivning, kontaktblock) behöver visas på ett dussin sidor. Redigera filen en gång, så uppdateras den automatiskt överallt.
• Innehåll från ett annat inlägg. Du inkluderade text från en annan sida via post_id, och den hålls synkroniserad: redigera på ett ställe, visa överallt.

Den främsta fördelen jämfört med en anpassad temamall: när du byter tema ligger dina filer kvar. Temat ändras, innehållet lever oberoende.

Installation och första körning

Installationen är standard, via WordPress adminpanel:

• Plugins → Lägg till nytt.
• Skriv "Include Me" i sökfältet.
• Hitta pluginet av Stefano Lissa, klicka på Installera nu → Aktivera.

Efter aktivering är pluginet redo att användas utan några inställningsskärmar. All "konfiguration" görs via shortcode-syntax.

Standard filsökväg: /wp-content/include-me/. Ladda upp filer du planerar att inkludera till denna mapp. Om du behöver en annan katalog, lägg till i wp-config.php:

1
define('INCLUDE_ME_DIR', '/path/to/your/folder');

Om du vill inkludera filer från var som helst på servern, ange en asterisk (men det är säkrare att begränsa till en mapp):

1
define('INCLUDE_ME_DIR', '*');

Viktig säkerhetsbegränsning: från och med version 1.3.0 körs shortcoden [includeme] endast i inlägg som ägs av en administratör. Filer söks som standard i webbplatsens rotmapp (ABSPATH och underliggande). Detta är ingen bugg utan en skyddsåtgärd: Include Me kör PHP-kod, och du bör inte ge den möjligheten till vem som helst.

Grundläggande syntax: inkludera HTML- och PHP-filer

Huvudshortcoden är [includeme file="filename"]. Den fungerar i alla inlägg, sidor eller widgetar (via do_shortcode).

Exempel 1: HTML-fil. Du har förberett price-table.html med prislayout och stilar. Du laddade upp den till /wp-content/include-me/. I inlägget skriver du:

1
[includeme file="price-table.html"]

Pluginet läser filen och infogar dess innehåll exakt där shortcoden är placerad. En <style>-tagg inuti filen fungerar. Inline JS fungerar. Ingen "sanering" av koden.

Exempel 2: PHP-skript. Filen report.php kör en SELECT från databasen och matar ut en tabell. Filändelsen .php är utlösaren för Include Me: pluginet läser inte bara filen utan kör den via include. Skriptets utdata (echo/print) hamnar i inlägget:

1
[includeme file="report.php"]

Exempel 3: Relativ sökväg. En sökväg utan inledande snedstreck (file="myfolder/data.html") är relativ till webbplatsens rot (ABSPATH). En absolut sökväg (file="/var/www/external/widget.html") utgår från serverns filsystemsrot. I de flesta fall använder du en relativ sökväg till en fil inuti /wp-content/include-me/.

Inkludera ett annat inlägg eller en sida via post_id

Utvecklarna av Include Me har lagt till syntax för att hämta innehåll från ett befintligt WordPress-inlägg. Shortcoden:

1
[includeme post_id="42"]

Där 42 är det numeriska ID:t för det önskade inlägget eller sidan. Så hittar du ID:t: i adminpanelen, för muspekaren över "Redigera"-länken för det önskade inlägget, så ser du post=42 i webbläsarens statusfält.

Denna teknik är praktisk för juridiska sidor. Integritetspolicyer eller användarvillkor dupliceras ofta: en instans på "föräldra"-sidan, resten använder Include Me med post_id. Juristen redigerar texten på ett ställe, och den uppdateras överallt.

Observera: endast inläggets innehåll hämtas, inte titeln. Om du också behöver titeln måste du duplicera den inuti innehållet eller använda [includeme file="..."] med ett PHP-skript som anropar get_post().

Iframe-läge: bädda in en extern URL

Den tredje syntaxen genererar en <iframe> istället för direkt inkludering:

1
[includeme src="https://example.com/widget"]

Eventuella ytterligare attribut skickas till <iframe> som HTML-attribut:

1
[includeme src="https://example.com/widget" frameborder="0" width="600" height="450"]

Resultatet är en fullständig iframe med de angivna måtten. Detta är ett alternativ till direkt inkludering för fall när:

• Du behöver visa en extern sida som ett "fönster" inuti inlägget.
• Det inkluderade innehållet måste leva i en isolerad kontext (egen CSS/JS som inte krockar med temat).
• Du behöver bädda in en interaktiv widget (kalkylator, karta) som inte ska köras i WordPress-kontexten.

Begränsning: iframe-läget kör inte PHP; det visar helt enkelt URL:en i en ram. För server-side-kod, använd file="...".

Skicka variabler till PHP-skript

Den mest kraftfulla funktionen i Include Me är att skicka parametrar från shortcoden till den inkluderade PHP-filen. I shortcoden skriver du:

1
[includeme file="greeting.php" name="Alexey" plan="Pro"]

Inuti greeting.php kommer du åt attributen via den globala arrayen $attrs:

1
<?php
2
$user_name = $attrs['name'] ?? 'Guest';
3
$user_plan = $attrs['plan'] ?? 'Free';
4
 
5
echo "<p>Hello, {$user_name}! Your plan: {$user_plan}.</p>";

Detta gör Include Me till en mini-templating-motor. Samma PHP-fil genererar olika utdata beroende på shortcode-attributen. Praktiska scenarier:

• Priskalkylator. Ett enda calc.php-skript tar emot base_price och discount från shortcoden och visar olika beräkningar på olika sidor.
• Personligt block. cta.php tar emot heading och button_text, varje inlägg har sin egen rubrik och knapp, men HTML-skelettet är gemensamt.
• Kunddashboard. client-stats.php tar emot client_id och matar ut data för en specifik kund från ett externt CRM.

Vad Include Me inte gör: begränsningar

Pluginet löser en smal uppgift och försöker inte vara en schweizisk armékniv. Nackdelar värda att känna till före installation:

• Endast administratörer. Shortcoden fungerar endast i inlägg författade av en administratör. Författare och redaktörer kan inte använda Include Me; detta är en avsiktlig säkerhetsbegränsning (version 1.2.2+).
• Ingen visuell redigerare. Inget gränssnitt i adminpanelen: pluginet lägger inte till en metabox för filval. Allt görs manuellt via shortcode.
• Filändelsen .php krävs för körning. En fil med namnet script.inc med PHP-kod kommer INTE att köras; pluginet infogar den som text. Byt namn på den till script.php.
• Ingen cachning. Varje shortcode-anrop läser filen från disk eller kör PHP-koden på nytt. För högtrafiksidor med tunga skript, cacha utdatan själv (via Transients API eller ett cachningsplugin på sidnivå).

⁉️🤔 Vanliga frågor

Fungerar Include Me med moderna WordPress-versioner?

Ja, pluginet är testat upp till WordPress 6.9.4 och kräver version 6.1 eller högre. Den senaste uppdateringen (1.3.7) släpptes i februari 2026, och skaparen upprätthåller kompatibilitet med varje större WP-release.

Är det säkert att inkludera PHP-filer via shortcode?

Sedan version 1.2.2 kör pluginet PHP-filer endast från en mapp inuti webbplatsens rot och endast för inlägg författade av administratörer. Detta förhindrar körning av godtycklig kod via XSS eller URL-substitution. Begränsa dessutom mappen via define('INCLUDE_ME_DIR', '...') och undvik att använda '*' om det inte är absolut nödvändigt.

Hur skiljer sig Include Me från pluginet Insert Pages?

Insert Pages fokuserar på att infoga innehåll från andra inlägg; det har en rik uppsättning formaterings- och omslagsalternativ. Include Me är enklare och utformat för att arbeta med filer: HTML, PHP, TXT. Om din uppgift bara är att dra in ett annat inlägg är Insert Pages mer praktiskt. Om du behöver PHP-skript och externa filer är Include Me valet.

Kan jag infoga samma fil på tio sidor?

Ja, det är precis vad pluginet är utformat för. En fil i /wp-content/include-me/ inkluderas via samma shortcode på valfritt antal sidor. Redigera filen, så uppdateras innehållet omedelbart överallt utan att spara om varje inlägg.

Varför matar min PHP-fil inte ut något?

Tre vanliga orsaker: (1) filen ligger inte i mappen INCLUDE_ME_DIR, och sökvägen är felaktig; (2) ett fatalt fel finns i PHP-koden (kontrollera WP_DEBUG och serverloggar); (3) filen sparades med filändelsen .html eller .inc istället för .php (Include Me kör endast .php).

Vad händer om pluginet slutar få uppdateringar?

Include Me består av bara några rader kod (enligt skaparen) och är inte beroende av externa tjänster. Även utan uppdateringar kommer det att fortsätta fungera i åratal; dess logik är inte knuten till WP REST API, block eller Gutenberg-specifika funktioner. Den grundläggande shortcode-mekanismen i WordPress har inte ändrats sedan version 2.5.

Vad du ska göra om du behöver mer: alternativ och nästa steg

Om Include Me inte täcker dina behov, här är två riktningar för expansion:

• Infoga inlägg med formatering: pluginet Insert Pages hämtar innehåll från andra inlägg med flexibla visningsinställningar (titel, utdrag, anpassad omslagskod).
• Full PHP-motor: pluginet WPCode (tidigare Insert Headers and Footers) låter dig infoga PHP-snuttar globalt eller villkorat, med syntaxmarkering och felkontroll.

Börja med Include Me: för den typiska uppgiften att "infoga en extern fil i ett inlägg" är det mer än tillräckligt. Och om du redan har använt detta plugin eller löst en liknande uppgift på annat sätt, dela i kommentarerna vilket verktyg du valde.