Nenaudojamų paveikslėlių valymas

1. Įdiegimas ir licencijos aktyvavimas

Įskiepio failą clean-unused-media-premium.zip atsisiųskite iš savo paskyros skilties Mano įskiepiai, ten pat rasite ir licencijos raktą (jis atsiunčiamas ir el. paštu po apmokėjimo). Kitų įskiepių nereikia – įskiepis tinka bet kuriai WordPress svetainei. Jei įdiegtas WooCommerce, papildomai tikrinamos prekių nuotraukos ir galerijos, o su WPML – ir vertimai.

Įjungus įskiepį, kairiajame meniu po Nustatymai atsiranda skiltis Medijos valymas. Jos puslapiai išdėstyti darbo eilės tvarka: 1. Skenavimas, 2. Rezultatai, 3. Šiukšliadėžė, 4. Žurnalas, toliau – Nustatymai ir Licencija.

Visos įskiepio funkcijos veikia ir be licencijos – ji reikalinga automatiniams atnaujinimams gauti. Kol licencija neaktyvi, įskiepių sąraše ir įskiepio puslapiuose rodomas raudonas pranešimas „Nenaudojamų paveikslėlių valymas: licencija neaktyvi arba pasibaigusi. Atnaujinimai išjungti.“ Licenciją aktyvuokite puslapyje Medijos valymas → Licencija.

2. Rekomenduojama eiga pirmą kartą

1. Pasidarykite pilną svetainės ir duomenų bazės atsarginę kopiją.
2. Atidarykite Medijos valymas → Nustatymai ir skiltyje Sauga įsitikinkite, kad pažymėta Šiukšliadėžė (numatytai ji įjungta).
3. Paleiskite skenavimą: 1. Skenavimas → Pradėti skenavimą.
4. Peržiūrėkite skirtuką Nenaudojami ir keliems failams paspauskite Gilus patikrinimas, kad įsitikintumėte rezultatų teisingumu.
5. Pradėkite nuo nedidelės porcijos (20–50 failų) ir patikrinkite, ar svetainėje visi paveikslėliai vietoje.
6. Tada trinkite likusius.

3. Skenavimas

Skenavimą paleiskite Medijos valymas → 1. Skenavimas mygtuku Pradėti skenavimą. Įskiepis peržiūri visą svetainę etapais: medijos biblioteką, įrašus, puslapius ir prekes, papildomus laukus (ACF, WooCommerce, Elementor ir kt.), nustatymus, valdiklius ir temos parinktis, kategorijas ir žymas, vartotojų laukus, komentarus ir atsiliepimus, WPML vertimus (jei jie yra), viešų svetainės puslapių HTML ir uploads katalogo failus. Galiausiai rezultatai palyginami ir suskirstomi į grupes.

Kiekviena užklausa serveriui dirba tik kelias sekundes (numatyta 15 s), todėl svetainė veikia įprastai, o pirkėjai nieko nepastebi. Progreso juosta rodo procentus ir dabartinį etapą, po ja – apdorotų eilučių skaičius ir veiksmų sąrašas.

• Nutraukti sustabdo skenavimą. Jei naršyklę uždarysite skenavimui nepasibaigus, vėl atidarius skenavimo puslapį jis tęsiamas nuo tos vietos, kur buvo sustota.
• Didelėse parduotuvėse pirmas skenavimas gali užtrukti nuo kelių minučių iki kelių dešimčių minučių. Tuo metu naršyklės langas turi likti atidarytas – arba naudokite Skenuoti fone (žr. „Darbas fone“).
• Kitą kartą skenavimo puslapyje matysite Paskutinis skenavimas datą ir kortelę Paskutinio skenavimo suvestinė – paspaudus grupę, atsidaro jos rezultatai.
• Ką skenuoti (failų tipai, plėtiniai, praleidžiami katalogai, viešų puslapių tikrinimas) ir kiek serveris dirba vienu kartu, nustatoma Medijos valymas → Nustatymai (žr. „Kiti nustatymai“).

4. Rezultatai ir „Kur rasta“

Medijos valymas → 2. Rezultatai viršuje rodo kiekvienos grupės kortelę su failų skaičiumi ir užimama vieta, o žemiau – tų pačių grupių skirtukus. Po skirtuku – trumpas paaiškinimas, ką grupė reiškia.

Lentelėje kiekvienam failui matote peržiūrą, pavadinimą ir kelią (medijos įrašams – ID ir nuorodą medijos įrašas, kitiems – žymą nėra bibliotekoje), statusą, dydį, įkėlimo datą ir veiksmus. Stulpelyje Kur rasta išvardytos vietos, kuriose failas aptiktas: įrašas ar prekė (pvz., „product: Kvapioji žvakė“), laukas („Laukas: _thumbnail_id“), nustatymas, kategorija, vartotojo laukas, komentaras arba viešo puslapio adresas – su nuorodomis į redagavimą ar patį puslapį.

Virš lentelės galite ieškoti pagal failo pavadinimą ir pakeisti rikiavimą (Rikiuoti pagal dydį, pagal datą ar pagal pavadinimą, Mažėjančiai / Didėjančiai) – pasirinkite ir spauskite Filtruoti. Numatytai sąrašas rikiuojamas nuo didžiausių failų, puslapyje rodoma 50 eilučių.

5. Gilus patikrinimas

Kiekvienos eilutės mygtukas Gilus patikrinimas (arba juostoje virš lentelės – Gilus patikrinimas pažymėtiems) atlieka tiesioginę paiešką duomenų bazėje būtent to failo:

• pagal failo pavadinimą be plėtinio – todėl randa ir visas jo miniatiūras (foto-300x200.jpg, foto-scaled.jpg);
• medijos įrašams – ir pagal wp-image-ID bei "id":ID;
• lentelėse posts, postmeta, options, termmeta, usermeta, comments.

Radus nuorodą, statusas iškart pakeičiamas į „Naudojamas“, eilutė pažaliuoja, stulpelyje Kur rasta atsiranda radiniai, o failo nebeleidžiama pažymėti trynimui. Neradus matote „Nuorodų nerasta. Failą saugu trinti.“ Patikrinimas ypač pravers skirtuke Galimai naudojami.

6. Trynimas

Trinti galima grupėse Nenaudojami, Failai be įrašo bibliotekoje, Likusios miniatiūros, Įrašai be failo, Galimai naudojami ir – jei įjungta – Didelių paveikslėlių originalai. Juostoje virš lentelės:

• Perkelti pažymėtus į šiukšliadėžę – tik varnelėmis pažymėti failai (skliaustuose – kiek pažymėta). Antraštės varnelė pažymi visus puslapyje esančius.
• Perkelti visus šiame sąraše – visi skirtuką (ir paiešką) atitinkantys failai, net jei jų tūkstančiai ir jie išdėstyti per kelis puslapius.
• Trinti – eilutės mygtukas vienam failui.

Jei nustatymuose šiukšliadėžė išjungta, mygtukai vadinasi Ištrinti pažymėtus ir Ištrinti visus šiame sąraše, o trynimas tampa negrįžtamas. Prieš kiekvieną trynimą naršyklė paprašo patvirtinimo.

Trynimas vyksta porcijomis – numatyta 20 failų vienu kartu (nustatymas Failų porcijoje (trinant)), todėl serveris neperkraunamas. Kartu su paveikslėliu pašalinamos visos jo miniatiūros, -scaled versija, originalas ir redagavimo atsarginės kopijos. Prieš šalinant kiekvieno failo statusas patikrinamas iš naujo – apsaugoti failai ir svetainės elementai praleidžiami. Pabaigoje paspaudę Atnaujinti sąrašą matysite atnaujintus skaičius.

Skirtuke Galimai naudojami trinti galima tik pažymėjus Leisti trinti „galimai naudojamus“ (rizikinga) – tada naršyklė dar kartą įspėja. Prieš tai būtinai atlikite gilų patikrinimą.

7. Darbas fone

Mygtukai Skenuoti fone (skenavimo puslapyje) ir Trinti fone (rezultatų juostoje) paleidžia darbą serveryje – naršyklę galima uždaryti, kompiuterį išjungti. Grįžus į įskiepio puslapį matoma eiga, o darbą galima sustabdyti mygtuku Sustabdyti foninį darbą. Trinti fone šalina visus atidaryto skirtuko failus, eigoje rodoma „Ištrinta … iš …“ ir atlaisvinta vieta.

• Darbas vyksta ciklais po 20 s (nustatymas Vieno foninio ciklo trukmė (sek.)): kiekvienas ciklas baigdamas pats pasikviečia kitą.
• WP-Cron veikia kaip apsauga, jei kuri nors užklausa nutrūktų, o kiekvienas administravimo puslapio atidarymas patikrina, ar darbas nesustojo, ir prireikus jį pajudina.
• Vienu metu vyksta tik vienas foninis darbas; kol jis nesibaigė, kito skenavimo ar trynimo paleisti negalima.
• Jei foninis darbas kelias minutes neduoda jokių žinių, pamatysite įspėjimą – tada jį sustabdykite ir paleiskite skenavimą įprastu būdu (su atidaryta naršykle).
• Jei svetainėje nustatyta DISABLE_WP_CRON, įskiepis apie tai įspėja: rekomenduojama serveryje turėti sisteminį cron, kviečiantį wp-cron.php kas 5 min.

Mygtukai matomi, kai nustatymuose pažymėta Leisti foninį darbą (numatytai pažymėta).

8. Šiukšliadėžė

Įskiepis nieko netrina iš karto. Kiekvienas ištrintas paveikslėlis su visomis miniatiūromis pirma perkeliamas į katalogą wp-content/uploads/cump-quarantine/, o medijos bibliotekos įrašas (visi laukai, ID, priskyrimas) išsaugomas atkūrimui. Puslapyje Medijos valymas → 3. Šiukšliadėžė (skaičius prie meniu punkto rodo, kiek įrašų joje yra) matote:

• peržiūrą – paveikslėlį matysite ir po ištrynimo (jis rodomas tik prisijungusiam administratoriui);
• kodėl failas ištrintas, jo dydį, kada ištrintas ir kada bus pašalintas visam laikui;
• veiksmus: Atkurti (grąžina failus ir medijos įrašą, jei įmanoma – su tuo pačiu ID), Trinti visam laikui, masinius Atkurti pažymėtus ir Ištrinti negrįžtamai bei Ištuštinti šiukšliadėžę.

Masiniai veiksmai vykdomi porcijomis, kaip ir trynimas. Praėjus nustatytam laikui (Kiek dienų laikyti šiukšliadėžėje, numatyta 30 d.) failai pašalinami automatiškai – stulpelyje Bus pašalinta matote datą (arba „netrukus“).

9. Trynimo žurnalas

Medijos valymas → 4. Žurnalas – visa trynimų istorija: data, failas, tipas (medijos įrašas, failas ar originalas) su priežastimi, dydis ir kiek failų pašalinta. Viršuje – kiek iš viso ištrinta ir atlaisvinta vietos bei kiek failų dabar yra šiukšliadėžėje. Skirtingai nei šiukšliadėžė, žurnalas rodo ir seniai galutinai pašalintus failus.

• Stulpelyje Atkūrimas – mygtukas Atkurti (kol failai šiukšliadėžėje), žyma Atkurta arba „Negalima – failų šiukšliadėžėje nebėra“.
• Eksportuoti CSV – visa istorija vienu CSV failu (atsidaro ir Excel).
• Išvalyti žurnalą – pašalina tik istoriją, patys failai neliečiami.

Kad duomenų bazė neaugtų be galo, kasdien automatiškai pašalinami senesni nei 90 d. žurnalo įrašai (nustatymas Kiek dienų saugoti trynimo žurnalą; 0 – saugoti neribotai). Įrašai, kurių failai dar guli šiukšliadėžėje, nešalinami niekada – nei automatiškai, nei mygtuku Išvalyti žurnalą.

10. „Niekada netrinti“ sąrašas

Kai kurių failų jokia programa neras – pavyzdžiui, paveikslėlio adresas įklijuotas į naujienlaiškio šabloną, spausdintą katalogą ar kitą svetainę. Tokius failus apsaugokite. Greičiausia – mygtuku Apsaugoti rezultatų lentelėje (ten pat apsaugą galima ir atšaukti mygtuku Atšaukti apsaugą). Apsaugoti failai gauna statusą „Apsaugotas“, atsiduria skirtuke Apsaugoti ir niekada netrinami – nei rankiniu būdu, nei „galimai naudojamų“ režimu, nei automatinio valymo ar tvarkaraščio metu.

Sąrašą galite redaguoti ir patys: Medijos valymas → Nustatymai, skiltis Niekada netrinti šių failų, po vieną įrašą eilutėje. Mygtukas Apsaugoti į sąrašą įrašo medijos įrašo ID (failams be įrašo – kelią).

Svetainės logotipas, piktograma (favicon), WooCommerce vietaženklis ir antraštės paveikslėlis apsaugoti automatiškai – jų į sąrašą įrašyti nereikia.

11. Valymas trinant įrašą ar prekę

Įskiepis gali pats išvalyti prekės ar įrašo nuotraukas, kai šį ištrinate galutinai (perkėlus į šiukšlinę niekas netrinama). Funkcija numatytai išjungta; ją įjungsite Medijos valymas → Nustatymai, skiltyje Automatinis valymas trinant įrašą ar prekę:

• Įjungti – „Galutinai ištrinus įrašą ar prekę, ištrinti ir jos paveikslėlius“.
• Kuriuos paveikslėlius: tik įkeltus per tą įrašą (saugiausia); įkeltus + pagrindinę nuotrauką + WooCommerce prekės galeriją (rekomenduojama, numatyta); arba viską, kas rasta įraše – papildomai turinyje ir laukuose (ACF, Elementor).
• Patikra prieš trynimą (numatyta pažymėta, labai rekomenduojama) – trinami tik paveikslėliai, kurių nenaudoja joks kitas įrašas, laukas ar nustatymas. Kitam įrašui priskirti paveikslėliai, apsaugoti failai ir svetainės elementai neliečiami niekada.
• Šiukšliadėžė – numatytai nepažymėta: kartu su galutinai ištrinta preke jos paveikslėliai šalinami iš karto (trynimas vis tiek įrašomas į žurnalą). Pažymėkite, jei norite turėti galimybę juos atkurti.
• Tik šiems įrašų tipams – pvz., product, product_variation; palikus tuščią, taikoma visiems įrašų tipams.

Daugiakalbėse svetainėse (WPML) patikra apima ir kitų kalbų versijas: paveikslėlis netrinamas, jei jį naudoja bent vienas vertimas.

12. Skenavimas pagal tvarkaraštį

Medijos valymas → Nustatymai, skiltyje Automatinis skenavimas pagal tvarkaraštį, pasirinkite Dažnis – Kasdien, Kas savaitę ar Kas mėnesį – ir valandą (numatyta 03:00; rekomenduojama naktis). Skenavimas vyksta fone tomis pačiomis porcijomis; jei tuo metu jau vyksta kitas foninis darbas, kartas praleidžiamas.

• Automatinis trynimas (numatytai išjungtas) – po suplanuoto skenavimo pašalina pažymėtų grupių failus: Nenaudojamas ir nepriskirtas (pažymėta), Failas be įrašo bibliotekoje, Likusi miniatiūra, Failo nėra serveryje. „Galimai naudojami“ ir didelių paveikslėlių originalai automatiškai netrinami niekada. Failai keliauja į šiukšliadėžę, todėl 30 d. juos dar galima atkurti.
• Ataskaita el. paštu – baigus suplanuotą darbą atsiunčiama suvestinė: kiek ko rasta, kiek pašalinta ir kiek vietos atlaisvinta. Palikus adresą tuščią, laiškas keliauja svetainės administratoriaus adresu.

13. Panaudojimas medijos bibliotekoje

Failai → Failų saugykla sąrašo rodinyje atsiranda stulpelis Panaudojimas: ta pati žyma kaip rezultatų lentelėje, kur failas rastas, nuoroda Tvarkyti (trinamiems failams – atidaro failą įskiepio rezultatuose) ir kada paskutinį kartą skenuota. Virš sąrašo – filtras Visi panaudojimo statusai, leidžiantis parodyti, pavyzdžiui, tik nenaudojamus failus.

Duomenys imami iš paskutinio skenavimo, todėl po naujų įkėlimų prie failo rodoma „Nėra duomenų“, kol nepaskenuojate iš naujo (jei skenavimas dar nė karto nevyko – „Neskenuota“ ir nuoroda Skenuoti). Stulpelį ir filtrą išjungsite nustatymuose: Medijos biblioteka → Statuso stulpelis.

14. Kiti nustatymai

Visi nustatymai yra viename puslapyje Medijos valymas → Nustatymai; pakeitę spauskite Išsaugoti nustatymus apačioje. Skenavimo nustatymų pakeitimai įsigalioja po kito skenavimo.

Ką skenuoti

• Failų tipai – Tik paveikslėliai (numatyta) arba Visi medijos failai (dokumentai, video ir kt.).
• Failų plėtiniai – kokių plėtinių failų ieškoti serveryje ir turinyje (numatyta: jpg, jpeg, png, gif, webp, avif, svg, bmp, ico, tif, tiff).
• Praleidžiami katalogai – uploads katalogai, kurių failai nesiūlomi trinti, po vieną eilutėje. Jau įrašyti kitų įskiepių katalogai: šiukšliadėžė, woocommerce_uploads, wc-logs, formų, talpyklos (cache), atsarginių kopijų, elementor ir kt.
• Papildomi šaltiniai: Ieškoti failų, kurių nėra medijos bibliotekoje (pažymėta), Atidaryti viešus svetainės puslapius ir tikrinti jų HTML (pažymėta; lėčiau, bet tiksliau – aptinka temos šablonuose įdėtus paveikslėlius), Įtraukti ir kategorijų / prekių kategorijų puslapius ir Tikrinti ir įrašų versijas (revizijas) (abu nepažymėti).
• Daugiausiai puslapių – kiek viešų puslapių atidaryti tikrinant HTML (numatyta 300; didelėms parduotuvėms rekomenduojama 300–1000).

Didelių paveikslėlių originalai

Įkėlus labai didelį paveikslėlį, WordPress sukuria mažesnę -scaled versiją ir visur rodo tik ją, o originalą palieka serveryje. Pažymėjus Siūlyti trinti nenaudojamus -scaled paveikslėlių originalus (numatytai nepažymėta), po kito skenavimo tokie originalai, kurių adresas svetainėje nerastas, renkami į atskirą kortelę ir skirtuką Didelių paveikslėlių originalai. Ištrynus originalą, matomas -scaled paveikslėlis ir medijos įrašas lieka nepaliesti.

Serverio apkrova

• Vienos užklausos trukmė (sek.) – kiek sekundžių dirba viena skenavimo ar trynimo porcija (numatyta 15; silpname serveryje naudokite 5–10).
• Porcijų dydžiai: Eilučių porcijoje (skenuojant) – 200, Įrašų porcijoje – 40, Failų porcijoje (trinant) – 20 (daugumai serverių tinka 10–25).
• Įrašų puslapyje – kiek eilučių rodyti rezultatų ir šiukšliadėžės lentelėse (numatyta 50).
• Miniatiūrų dydis – skaičiuoti ir miniatiūrų užimamą vietą (pažymėta; tiksliau, bet skenavimas šiek tiek lėtesnis).

Foninis darbas, WPML ir sauga

• Leisti foninį darbą (pažymėta) ir Vieno foninio ciklo trukmė (sek.) – 20; žr. „Darbas fone“.
• WPML palaikymas (pažymėta) – kitos kalbos versijos naudojimas laikomas ir originalo naudojimu, papildomai skenuojamos WPML eilučių vertimų lentelės. Be WPML šis nustatymas nieko nekeičia.
• Šiukšliadėžė (pažymėta), Kiek dienų laikyti šiukšliadėžėje – 30, Kiek dienų saugoti trynimo žurnalą – 90 (0 – neribotai).
• Nesiūlyti trinti naujesnių nei (dienos) – pravers, jei paveikslėlius įkeliate iš anksto, prieš publikuodami turinį; tokie failai žymimi „Galimai naudojamas“ (numatyta 0 – riba netaikoma).
• Įskiepio pašalinimas – „Ištrinant įskiepį nepalikti duomenų bazėje jokių jo pėdsakų“ (numatytai nepažymėta), žr. „Sauga ir duomenys“.

15. WP-CLI

Labai didelėms svetainėms patogiau dirbti komandine eilute (jei serveryje yra WP-CLI):

wp media-cleaner scan
wp media-cleaner status
wp media-cleaner list --status=unused --limit=50
wp media-cleaner delete --status=unused --dry-run
wp media-cleaner delete --status=orphan_thumb
wp media-cleaner restore 42

• scan – pilnas skenavimas; pabaigoje parodoma suvestinė (tą pačią rodo status).
• list – rasti failai: --status (unused, maybe_used, orphan_file, orphan_thumb, missing…; numatyta unused) ir --limit (numatyta 20).
• delete – trina porcijomis; --dry-run tik parodo, kiek failų būtų ištrinta, --limit riboja kiekį, --force leidžia trinti ir „galimai naudojamus“. Kai šiukšliadėžė įjungta, failai keliauja į ją.
• restore 42 – atkuria failą iš šiukšliadėžės pagal žurnalo įrašo ID.

16. Kaip veikia atpažinimas

Kiekvienam paveikslėliui įskiepis registruoja tris nuorodų tipus:

• pagal ID – wp-image-123, [gallery ids="1,2,3"], Gutenberg blokų "id":123, _thumbnail_id, prekės galerija;
• pagal normalizuotą pavadinimą – foto-300x200.jpg, foto-scaled.jpg ir foto@2x.jpg suvedami į foto.jpg, todėl pakanka bet kurio dydžio nuorodos, kad originalas būtų laikomas naudojamu;
• pagal tikslų pavadinimą – pavienėms miniatiūroms, kad senos, WordPress nebežinomos miniatiūros būtų atpažintos kaip nereikalingos, net jei originalas naudojamas.

Sprendimai priimami saugia kryptimi: kilus bent menkiausiai abejonei, failas žymimas kaip naudojamas arba „galimai naudojamas“, o ne siūlomas trinti. Daugiakalbėse svetainėse ta pati nuotrauka skirtingomis kalbomis laikoma viena.

Žinomi apribojimai

• Jei du skirtingų katalogų failai turi tą patį pavadinimą (2020/01/foto.jpg ir 2023/07/foto.jpg), vieno panaudojimas apsaugo abu – sąmoningas pasirinkimas saugumo naudai.
• Skaitinės reikšmės nežinomos paskirties laukuose duoda statusą „Galimai naudojamas“ – tam ir yra gilus patikrinimas.
• Jei paveikslėlis įterpiamas tik JavaScript kodu iš išorinio šaltinio, jo aptikti neįmanoma – todėl prieš pirmą masinį trynimą visada pasidarykite atsarginę kopiją.
• Viešų puslapių tikrinimas neveiks, jei svetainė uždaryta slaptažodžiu (HTTP auth) arba „coming soon“ režimu.
• Didelių paveikslėlių originalų panaudojimo neįmanoma įrodyti, jei tema ar įskiepis originalo adresą sugeneruoja programiškai. Originalai, kuriuos WordPress paliko pasukdamas (-rotated) ar konvertuodamas formatą (pvz., HEIC → JPG), sąmoningai nesiūlomi.

17. Sauga ir duomenys

• Trinami tik failai, esantys uploads kataloge (tikrinama per realpath), o prieš trinant kiekvieno failo statusas ir apsauga patikrinami iš naujo.
• Šiukšlinėje esančiam įrašui priskirti paveikslėliai netrinami – jie žymimi „Galimai naudojamas“, nes įrašą dar galima atkurti.
• Failai, priklausantys medijos bibliotekos įrašui, niekada netrinami kaip „pamesti“ (išimtis – įjungti didelių paveikslėlių originalai, kuriems prieš trynimą atliekamos papildomos patikros).
• Šiukšliadėžės katalogas apsaugotas nuo tiesioginio pasiekimo (.htaccess), o peržiūros paveikslėlį įskiepis rodo tik teises turinčiam vartotojui.
• Visi veiksmai reikalauja administratoriaus teisių (manage_options) ir apsaugos nuo suklastotų užklausų (nonce).
• Nustatymai, skenavimo rezultatai, žurnalas ir licencija laikomi nuosavose įskiepio lentelėse. Pažymėjus Ištrinant įskiepį nepalikti duomenų bazėje jokių jo pėdsakų (Nustatymai → Sauga), ištrynus įskiepį visos jo lentelės pašalinamos; šiukšliadėžėje esantys failai lieka nepaliesti. Tinkle (multisite) apeinamos visos tinklo svetainės.
• Išjungus įskiepį sustabdomi foniniai darbai ir suplanuotos užduotys.