Duplicate Media — Asennus- ja käyttöohje (FI)

Versio: 2.2.7
Lisenssi: Lifetime (kertamaksu, jatkuvat päivitykset)

1) Yhteenveto

Duplicate Media lisää Media‑kirjaston listanäkymään toiminnon Duplicate, jolla voit kopioida valitun liitetiedoston (esim. kuvan) uuteen tiedostoon ja luoda sille uuden liitepostin. ALT‑teksti kopioidaan alkuperäisestä, ja WordPressin metatiedot (koot ym.) generoidaan uudelleen.

2) Vaatimukset ja yhteensopivuus

• WordPress 5.4+ (suositus 5.8+).
• Käyttöoikeus: upload_files (tyypillisesti editori/kirjoittaja tai ylläpitäjä).
• Käännökset: lisäosa lataa kielitiedostot hakemistosta /languages.

3) Asennus

1. Siirry Lisäosat → Lisää uusi → Lataa lisäosa ja valitse ZIP.
2. Klikkaa Asenna nyt, sitten Ota käyttöön.
3. Aktivoinnin jälkeen lisenssin syöttö on suositeltavaa (ks. kohta 4), jotta automaattiset päivitykset toimivat.

Päivitys: asenna päivitykset normaalisti WordPressin Lisäosat‑näkymästä. Lisäosa tarkistaa päivitykset Lieska‑päivityspalvelusta.

4) Lisenssi (Lifetime) ja päivitykset

• Lisenssi on lifetime: kertamaksu, ei vuosiuusintaa.
• Syötä lisenssi kohdassa Asetukset → Lieska Plugin Licenses (ankkuri #duplicate-media).
• Jos lisenssi puuttuu, WordPress‑kojelauta näyttää huomautuksen ja päivitysviestissä kerrotaan lisätiedot.

5) Käyttö

5.1 Media‑kirjasto (lista)

1. Avaa Media → Kirjasto listanäkymässä.
2. Siirrä hiiri liitteen rivin päälle → klikkaa Duplicate.
3. Onnistuneen kopioinnin jälkeen saat vahvistuksen, ja sivu päivittyy. Uusi liitetiedosto on fyysinen kopio (uusi tiedosto uploads‑kansiossa), ja sillä on oma liitepostinsa.

Mitä kopioidaan?

• Tiedosto kopioidaan uploads‑polkuun uuteen nimeen (muotoa *-copy-<timestamp>.ext>, taustalla varmistetaan uniikki nimi).
• MIME‑tyyppi & metat tarkistetaan ja generoidaan (wp_generate_attachment_metadata).
• ALT‑teksti kopioidaan, jos se on asetettu alkuperäisessä.

5.2 Rajoitukset ja huomioita

• Toiminto on saatavilla vain listanäkymässä (media_row_actions).
• Nonce‑tarkistus ja käyttöoikeusvaatimus estävät väärinkäytökset.
• Jos kopiointi epäonnistuu (esim. tiedostopolku ei kirjoitettavissa), näyttöön tulee virheilmoitus.

6) Asetukset

Duplicate Media ei lisää erillistä asetussivua. Lisenssi syötetään keskitetylle sivulle:
Asetukset → Lieska Plugin Licenses → #duplicate-media.

7) Ylläpito ja tietoturva

• Kopiointi käyttää WordPressin uploads‑polkua ja noudattaa wp_upload_dir()‑logiikkaa.
• Lisäosa suorittaa nonce‑tarkistuksen ja edellyttää upload_files‑ominaisuutta.
• Jos palvelimen tiedostooikeudet ovat tiukat, varmista, että uploads‑hakemisto on kirjoitettavissa.

8) Vianmääritys

• You do not have permission → käyttäjäroolilta puuttuu upload_files.
• Attachment not found / File not found → alkuperäinen liite tai tiedostopolku puuttuu/siirretty.
• Uploads directory is not available → tarkista wp_upload_dir()‑polut ja oikeudet.
• File copy failed → palvelimen tiedosto‑oikeudet/kiintiöt/levytila; tarkista myös avoimet lukkotilanteet.
• Failed to create the attachment → tiedoston metadatan generointi tai tietokantakirjoitus epäonnistui.
• Käännökset eivät näy → varmista, että /languages‑hakemisto ja tekstit ovat saatavilla.

9) UKK

K: Kopioiko lisäosa myös kuvakoot ja metadatan?
V: Kyllä. Uudelle liitteelle ajetaan wp_generate_attachment_metadata() ja metat tallennetaan normaalisti.

K: Säilyykö ALT‑teksti?
V: Kyllä, jos alkuperäisellä liitteellä on ALT‑arvo, se kopioidaan uuteen.

K: Missä kohtaa syötän lisenssin?
V: Asetukset → Lieska Plugin Licenses → #duplicate-media.

K: Tarvitaanko OpenAI‑avainta?
V: Ei. Duplicate Media ei käytä ulkoisia API‑kutsuja. (Huom: muissa Lieska‑lisäosissa, kuten AI Alt Text, avain vaaditaan.)

K: Tukeeko tämä WP‑CLI:tä tai CRONia?
V: Ei sisällä erillistä CRON‑toimintoa; kopiointi tehdään käyttäjän klikkauksesta Media‑kirjastossa.

10) Tuki

• Lisenssi & päivitykset: noudata sivun ohjeita Asetukset → Lieska Plugin Licenses.
• Yhteys: plugins.lieska.net

© Lieska — Kaikki oikeudet pidätetään.