Egenverk Lagom · Dokumentation

CSS och JS

Modulen CSS och JS per sida ligger på fliken Advanced, som du först slår på för dig själv, se Kom igång. Den visar vilka filer varje sorts sida laddar och låter dig stoppa en fil på valda sidtyper, eller ett helt tillägg på valda adresser. Modulen är av från start.

Lagom skriver aldrig om eller slår ihop kod. Det stoppar alltid en hel fil eller ett helt tillägg, och varje regel börjar som förhandsvisning.

Skanna sidorna

Med modulen på visar kortet en länk per sorts sida: startsida, butik, varukorg, kassa, mitt konto, en produkt, en produktkategori, ett blogginlägg, adminpanelen och ordrar. Öppna var och en en gång medan du är inloggad. Andra sidor skannar du genom att lägga till ?egenverk_lagom_assets=scan i adressen.

Lagom noterar varje CSS- och JS-fil som sidan skrev ut, och en notis på sidan bekräftar vad som noterades. Under Skannade filer grupperas filerna per tillägg, tema eller WordPress, största först:

• Handtag och typ, CSS eller JS
• storlek och inline-kod
• Fil som skickas, om den är minifierad och om den andra versionen finns på disk
• Laddas på: sidtyperna där filen laddas
• Behövs av: filer som är beroende av den
• Senaste körning: vad den senaste täckningskörningen såg

Skanningar sparas per sidtyp, högst 40 sidtyper med 300 filer var. Sidtyperna är startsida, blogg, sida (per sidmall), inlägg per inläggstyp, sök, 404, arkiv, butik, produkt, produktkategori, varukorg, kassa, orderbetalning, orderbekräftelse, konto och varje adminskärm. Anrop utan skanningsparametern påverkas inte, och en skannad sida hålls utanför sidcacher.

Regler för filer

Klicka på Stäng av… vid en fil, bocka i sidtyperna under Sluta ladda den på och klicka på Lägg till som förhandsvisning.

Förhandsvisning: en ny regel gäller bara när en administratör öppnar en sida med ?egenverk_lagom_assets=preview. Sidtyperna vid regeln är länkar till förhandsvisningen, och en notis på sidan säger hur många regler som användes.

En regel nekas när

• den gäller Lagoms egen sida, så att en dålig regel alltid går att ångra
• den gäller WooCommerces orderskärmar i wp-admin, där återbetalningar och dragningar görs
• den gäller orderbetalning eller orderbekräftelse, som kräver en riktig order och aldrig kan kontrolleras
• filen inte syntes på sidtypen i senaste skanningen
• filen kommer från ett tillägg för betalning, frakt, cache, säkerhet, cookie-samtycke, språk eller kodsnuttar och sidtypen är en produkt-, butiks-, varukorgs-, kass- eller kontosida
• en fil som är beroende av den fortfarande skulle laddas på sidtypen

Låt gälla alla: en regel blir live efter en godkänd kontroll, se nedan. Utan kontroll kan en administratör göra den live genom att bocka i ”Ingen kontrollkörning har godkänts. Jag har själv kontrollerat förhandsvisningen och tar risken; detta loggas.” Det loggas och regeln märks kontrollen hoppades över. Regler på produkt-, butiks-, produktkategori-, varukorgs-, kass- och kontosidor kan aldrig hoppa över kontrollen.

WordPress lägger tillbaka en borttagen fil när något som laddas är beroende av den. En regel blir därför live först när reglerna för filerna som beror på den är live, och en regel som andra live-regler beror på kan inte tas ur live först.

En regel kan gå Tillbaka till förhandsvisning eller Ta bort. Efter varje ändring töms kända sidcacher (WP Rocket, LiteSpeed Cache, W3 Total Cache, där bara sidcachen töms, och WP Super Cache). Annars ber Lagom dig tömma cachen. Ändringslogg sparar de 200 senaste regeländringarna med vem, när och vad.

?egenverk_lagom_assets=off stänger av alla regler för ett enda anrop.

Täckning och kontroll

En täckningskörning mäter vilka filer varje sidtyp faktiskt använder. Den görs i en webbläsare utan fönster på din egen dator med verktyget bin/lagom-coverage från tilläggets källkod. Verktyget ingår inte i tilläggets zip-fil. Kontakta oss om du vill använda det.

Plan: under Täckningskörningar bockar du i en sida per sidtyp under Ta med, lägger till egna adresser under Fler adresser och klickar på Spara planen. En sida per sidtyp räcker: alla kategorisidor räknas som en.

Környckel: Skapa környckel visar nyckeln en gång, tillsammans med kommandona för att mäta och kontrollera. Den gäller i 30 minuter, bara för din användare och den körningen. Den sparas bara som hash, loggas i Körlogg och kan återkallas med Återkalla, vilket också avslutar inloggningen den lämnat ut. En ny nyckel ersätter din förra.

Resultat: per fil och sidtyp visar Lagom oanvänd här, bara uppstart, bara typsnitt eller animationer, kontrollera med ögonen eller används, med hur stor del av filen som användes. Varje sida besöks i dator- och mobilstorlek.

Föreslagna regler: efter en körning listar Lagom per sidtyp CSS utan matchande regler (förbockade) och JS som bara körde sin startkod (att välja själv). Lägg till ibockade som förhandsvisningsregler lägger till dem som förhandsvisning.

Kontroll: kontrollkörningen öppnar varje sidtyp som har regler i förhandsvisning, med reglerna av och på, och jämför konsolfel, misslyckade anrop, interaktioner som slutar fungera och layouten. Reglerna visar per sidtyp kontrollerad, kontrollen misslyckades med skälen, reglerna har ändrats, kontrollera igen eller inte kontrollerad. En godkänd kontroll gäller exakt de regler som finns på sidtypen, och regler som kontrollerats tillsammans blir live tillsammans. Notisen räknar upp dem.

Produktion bara läser: när WordPress miljötyp är production blockerar körningen spårning, avbryter alla anrop som inte är GET, lämnar aldrig sidan den öppnade och klickar inte på något i wp-admin. Produkt-, butiks-, produktkategori-, varukorgs- och kassasidor godkänns bara i en full körning, som kan fylla en varukorg, alltså i en testmiljö. Kontosidor kan godkännas även i en körning som bara läser.

Hela tillägg per adress

En tilläggsregel stoppar ett aktivt tillägg från att laddas alls, med PHP, CSS och JS, på valda adresser. Ett vanligt tillägg laddas för sent för att stoppa andra, så det kräver ett litet must-use-tillägg, egenverk-lagom-plugin-filter.php i wp-content/mu-plugins/. Lagom skriver det bara när du klickar på Installera mu-tillägget. Kortet visar dess läge: Inte installerat: tilläggsregler gör ingenting., Installerat och aktuellt. eller Installerat av en annan Lagom-version: uppdatera det. En gammal version byts ut automatiskt när en administratör öppnar admin, och Ta bort mu-tillägget tar bort det.

Så lägger du till en regel: välj Tillägg, välj under Stäng av det antingen på adresser som börjar med eller på exakt den här adressen, fyll i Adress, till exempel /blog/, och klicka på Lägg till tilläggsregel som förhandsvisning. Adressen måste täcka minst en skannad sida, så att regeln kan kontrolleras. Prefix matchar hela sökvägssegment: /blog/ gäller /blog/x/ men inte /blog-posts/. Stora och små bokstäver och index.php spelar ingen roll.

Det här stängs aldrig av: WooCommerce, Lagom, tillägg för betalning, frakt, cache, säkerhet, cookie-samtycke, språk eller valuta och kodsnuttar, och tillägg som ett annat aktivt tillägg kräver. De går inte att välja.

Must-use-tillägget gör ingenting

• i wp-admin, på AJAX, REST, cron, WP-CLI eller XML-RPC
• vid inloggning, formulärinskick (bara GET och HEAD gäller), WooCommerce API-anrop, förhandsvisningar, flöden, webbplatskartor, robots.txt eller sökningar
• på varukorg, kassa, kontosidor och ordersidor, som alltid står i undantagslistan och följer med om du byter eller byter namn på de sidorna i WooCommerce
• på adresserna i Undantagslista, en per rad, som du sparar med Spara undantagslistan
• med enkla permalänkar, eller när Lagom inte är aktivt

Om något sparar listan över aktiva tillägg medan en regel har kortat den, läggs de avstängda tilläggen tillbaka, så att de aldrig avaktiveras för hela sajten.

Tilläggsregler går genom samma steg som filregler: förhandsvisning, kontroll, live och logg. En tilläggsregel kan inte bli live utan aktuellt must-use-tillägg.

Så stoppar du alla tilläggsregler på en gång:

• avaktivera Lagom, som då tar bort filen och tömmer sidcachen. Reglerna sparas, och när du installerar must-use-tillägget igen gäller de igen.
• lägg till define( 'EGENVERK_LAGOM_RULES_OFF', true ); i wp-config.php
• radera filen i wp-content/mu-plugins/

Slår du av modulen tas filen också bort.

PageSpeed Insights

Som en andra åsikt listar avsnittet PageSpeed Insights, märkt uppskattning, bara publika sidor, varje skannad publik sidtyp. Välj Enhet, mobil eller dator, och klicka på Kör PageSpeed. Google öppnar sidan en gång, utloggat och med tom varukorg, klickar inte på något och rapporterar poäng, LCP, TBT och CLS och hur mycket av varje CSS- och JS-fil som inte användes. Resultaten skapar inga regler. Ett resultat där Google skickades vidare till en annan sida sparas inte.

API-nyckel är valfri. Utan den tillåter Google bara några körningar per dag. Spara nyckeln med Spara nyckeln, ta bort den med Ta bort nyckeln, eller sätt konstanten EGENVERK_LAGOM_PSI_KEY i wp-config.php, se Referens. Nyckeln visas aldrig igen. Den skickas bara i serverns anrop till Google och tvättas bort ur felmeddelanden. Adressen som skickas är alltid en skannad sida på din sajt.