Egenverk Lagom · Dokumentation

Moduler

Alla moduler är av från start och slås på var för sig. Den här sidan följer flikarna i Lagom. CSS och JS per sida har en egen sida: CSS och JS.

Prestanda

Adminpanelens widgets

Med modulen på byggs de widgets du valt inte alls, för någon användare. Deras kod körs då inte. Att dölja en widget under Panelinställningar döljer den bara, koden körs ändå.

Under Widgets som finns på Adminpanelen listas varje widget som Lagom har sett, med ett reglage per widget. Listan fylls när en administratör öppnar adminpanelen, så öppna den en gång efter aktiveringen. En widget som Lagom tagit bort ligger kvar i listan och kan slås på igen. Det som ett tillägg gör när det registrerar sin widget påverkas inte, och inte heller skript det laddar för adminpanelen. Sådana filer stoppar du med reglerna under CSS och JS.

Raden Banners visas bara när ett tillägg med en känd banner är installerat. I dag gäller det en betaltjänsts ”Go live”-banner, som visas på adminpanelen medan tjänsten är i testläge. Den är av från start.

Anropsvakt

Anropsvakten räknar anrop per endpoint och minut och varnar när ett skenar:

• wc-ajax, per endpoint
• admin-ajax.php, per action, med Heartbeat på en egen rad
• REST, per route-mönster, så att /wp/v2/pages/3 och /wp/v2/pages/4 blir en rad. Okända routes räknas som no-route, och anrop som nekas innan de körs räknas på sin sökväg med siffror som {id}.
• wp-cron.php

Varje anrop lägger en kort rad i en fil för den minuten under uploads/egenverk-lagom/watch/. Ingenting skrivs till databasen under anropet. En fil slutar växa vid 2 MB. Ett WP-Cron-jobb summerar färdiga minuter varje minut och tar bort filerna. Filer äldre än ett dygn tas bort utan att läsas.

Med modulen på visar kortet de 25 endpoints som haft flest anrop under en minut den senaste timmen: typ, endpoint, totalt, högsta antal per minut och senaste minuten. Det säger när summeringen senast kördes och varnar när WP-Cron inte har körts på tio minuter, när mappen inte går att skriva till eller när en minut nådde taket på 2 MB.

Slår du av modulen slutar den räkna, tömmer listan med varningar och tar bort filerna, en gång direkt och en gång tio minuter senare.

Heartbeat, transients och sessioner

Med modulen på:

• Heartbeat i admin: välj var 15:e s, var 30:e s, var 60:e s eller var 120:e s. Förvalt är var 60:e sekund.
• Varje natt klockan 03:00 i sajtens tidszon, även över sommartidsbyten, ber Lagom WordPress ta bort utgångna transients och tar själv bort utgångna WooCommerce-sessioner, 500 åt gången i högst 20 sekunder.

WordPress lämnar utgångna transients kvar i databasen när en beständig objektcache är aktiv. Lagom ber WordPress ta bort dem ur databasen ändå.

Modulen går bara att slå på efter att Visa vad som skulle tas bort har räknat inom de senaste tio minuterna. Räkningen visar hur många utgångna transients och butikssessioner nattens körning skulle ta bort, och om en beständig objektcache används. Att byta intervall för heartbeat kräver ingen ny räkning.

Med modulen på visar kortet Nästa körning och de tio senaste körningarna. Loggen sparar de 60 senaste.

Ordersök

Snabbt ordersök

Med modulen på läser Lagom söktermen på orderlistan innan något söks och slår upp varje tolkning i en indexerad kolumn, i stället för att WooCommerce söker igenom alla orderfält. WooCommerces eget sök körs inte.

Så tolkas termen:

• innehåller @: e-post. Slutar den med * söks början av adressen.
• börjar som ett UUID: transaktions-id
• # följt av siffror: ordernummer
• börjar med +46 eller 0046, eller med 0 följt av 7–10 siffror, med eller utan blanksteg och bindestreck: telefon, läst som +46…
• tre siffror, mellanslag, två siffror: postnummer
• fem siffror: ordernummer eller postnummer
• nio siffror utan nolla först: ordernummer eller telefon
• andra siffror, upp till 13: ordernummer
• text: namn. Ett ord matchar början av förnamn, efternamn eller företag. Två ord matchar början av förnamn och efternamn.

En notis på orderlistan säger hur termen tolkades, till exempel ”Snabbsöket tolkade detta som …”, och länkar till Sök i alla fält (långsamt), som kör WooCommerces vanliga sök. Saknar en del av termen snabbt uppslag på sajten säger notisen att de ordrarna inte visas. Ordersöket visar högst 500 träffar, nyaste först.

Kortet säger var svaren kommer ifrån på din sajt:

1. Ett annat tillägg som svarar via filtret egenverk_lagom_order_search, se Referens.
2. HPOS-tabellerna när HPOS är på: ordernummer, e-post, transaktions-id och telefon. Namn och postnummer bara där sajten har index på de kolumnerna. Kortet säger vilka index som saknas, och de sökningarna ger inga träffar förrän ett index finns.
3. Lagoms eget index när ordrarna lagras som inlägg. Utan det hittas bara ordernummer snabbt.

Lagoms eget sökindex

Reglagen för indexet syns på kortet när fliken Advanced är på för dig, se Kom igång.

• Bygg Lagoms eget sökindex (av från start) bygger tabellen {prefix}egvl_order_index, med en rad per order: faktureringens e-post, telefon, postnummer, förnamn, efternamn och företag i normaliserad form, plus transaktions-id. Varje kolumn är indexerad.
• Bygg bara nattetid (00–06) (av från start) fyller indexet bara mellan 00 och 06 i sajtens tidszon.

Indexet fylls via Action Scheduler i omgångar om 500 ordrar med 20 sekunders paus. Stänger du av reglaget, eller hela modulen, pausas fyllningen och det som är byggt ligger kvar. Dör en omgång startar nästa sidladdning i admin om fyllningen. Kortet visar hur många ordrar som är indexerade, och ordersöket använder indexet först när det är komplett.

När tabellen finns hålls den i takt med ordrarna även när fyllningen är pausad: rader läggs till och uppdateras när ordrar skapas eller sparas och tas bort när en order raderas eller anonymiseras. Indexet innehåller personuppgifter, se Data och integritet.

Utseende

Skal

Skalet ger wp-admin Egenverks färger: adminmenyn, adminfältet och bakgrunden delar en färg, en skärms innehåll ligger på ett ark och fälten och knapparna blir mjukare. Modulen är av från start. En förhandsvisning bredvid inställningarna visar hela adminen med dina val.

Typsnitten ligger i tillägget och laddas bara i admin, bara det valda.

På sin profil har varje användare Använd Lagom-skalet för att stänga av skalet för sig själv, och Färgläge med Ljust, Mörkt och Auto (följer systemet). Det är samma val som Läge på fliken.

Med skalet på:

• får inloggningssidan samma utseende. Utloggade besökare följer webbläsarens ljusa eller mörka läge.
• visar adminfältet en miljöbadge när sajten inte är markerad som produktion.
• blir kryssrutor i inställningsformulär till reglage, men inte på WooCommerces orderskärmar eller i kassainställningarna.

Blockredigeraren lämnas alltid orörd. Lägg till ?egenverk_lagom_skin=0 i adressen för att se en sida utan skal.

Advanced

Modulerna här syns bara när fliken Advanced är på för dig, se Kom igång.

Schematabeller

Modulen låter Action Schedulers egen städare ta bort färdiga och misslyckade jobb, med sina loggar, tidigare än den gör själv. Lagom ställer bara in städarens filter. Väntande jobb rörs inte.

Avbrutna jobb som aldrig kördes tar Action Scheduler bort vid nästa rensning, oavsett antal dagar. Action Scheduler 4.0 och senare tar själv bort misslyckade jobb. Äldre versioner gör det aldrig, och där lägger Lagom till ett dagligt jobb som ber Action Schedulers städare göra det.

Modulen går bara att slå på när Visa vad som skulle tas bort har räknat med exakt de värden som står i formuläret inom de senaste tio minuterna. Det gäller också när du sänker en lagringstid medan modulen är på. Räkningen visar hur många färdiga, avbrutna och misslyckade jobb och loggrader som skulle tas bort, vilka jobb de flesta misslyckade kommer från, vilken version av Action Scheduler som körs och loggrader som inte hör till något jobb. De lämnas orörda.

Loggen sparar borttagningar per dag och källa, högst 200 rader. Kortet visar de 20 senaste och summan för de senaste 30 dagarna.

Databas

Med modulen på visar Tabeller och autoladdade inställningar de 25 största tabellerna med sajtens prefix, plus mindre tabeller som går att optimera, och de 20 största autoladdade inställningarna med en gissning om vilket tillägg som äger dem. Ingenting tas bort.

Optimera en tabell gör du en i taget, efter att ha bockat i Jag förstår att tabellen byggs om och kan låsas en kort stund. Knappen finns bara när

• tabellen inte är en tabell som butiken skriver till vid varje besök eller order: WordPress egna tabeller, WooCommerces och Action Schedulers
• tabellen är InnoDB och har en egen tabellfil (innodb_file_per_table)
• tabellen är högst 500 MB
• den har minst 20 MB och minst 20 % ledigt utrymme inuti
• databasen ligger på samma server och dess datakatalog har minst dubbla tabellens storlek ledigt
• tabellen inte hör till en annan sajt i ett nätverk

Annars står skälet där knappen hade varit. Bara en ombyggnad körs åt gången.

Sluta autoladda stoppar autoladdningen för en inställning. Värdet ändras inte och tas inte bort. Skyddade inställningar, som WordPress grundinställningar, widgets, teman och transients, är märkta Skyddad. Varje ändring hamnar under Senaste databasändringar och kan ångras med Ångra, som ger tillbaka exakt det autoload-värde inställningen hade.

Loggen sparar de 100 senaste ändringarna, och kortet visar de tio senaste. Autoload-ändringar ligger kvar om Lagom avinstalleras, se Data och integritet.