Slik publiserer du en PDF-fil i ProcessWire – fra bunnen av

Slik publiserer du en PDF-fil i ProcessWire – fra bunnen av

Å publisere en PDF-fil i ProcessWire er enkelt, og kan gjøres i tekstredigeringsfeltet eller egne felter. Bak noe enkelt finnes som regel et godt system, og det er hele veien fra oppsett til publisering jeg skal se på i dette innlegget.

Mens noen publiseringsløsninger har en ferdig oppsatt metode for opplasting og publisering av PDF-filer, legger ProcessWire til rette for at du skal kunne gjorde det på din måte. Hva som passer ditt bruk, er noe du bør vurdere selv. For mange vil WordPress fungere ypperlig, med et mediebibliotek og et komplett tekstredigeringsverktøy ut av boksen.

Vil du derimot ha ting på en bestemt måte, og ønsker å sette det opp fra bunnen med kun det nødvendige, så kan fremgangsmåten i dette innlegget være noe for deg. Her legger jeg vekt på at vi legger til funksjonalitet. Mens du i WordPress muligens må ta vekk funksjonalitet for å få det helt som du vil.

Dette går jeg gjennom

  • Oppretting av et felt for filopplasting, og et for tekstredigering

  • Oppretting av sidemal

  • Opplasting av fil

  • Visning av siden

Kom i gang

I denne veiledningen tar jeg utgangspunktet i ProcessWire versjon 3.0.165, den nyeste stabile versjonen i skrivende stund. Jeg har installert den lokalt på egen maskin, og har språkmodulene som følger med, sånn at norsk språkpakke (processwire.com) også kunne bli installert.

Oppretting av felt for filopplasting

  1. For å opprette et felt går du til Oppsett, deretter Felter.

  2. Trykk på Legg til nytt felt.

  3. Skriv inn navn, velg Filer som type, og skriv inn en merkelapp.

  4. Gå gjennom Detaljer.

    1. Jeg velger å la alle filetternavn bli stående, da jeg ønsker et felt som kan brukes til formål.

    2. Deretter velger jeg HTML Entity Encoder (htmlspecialchars) som Text formatter, så kun ren tekst kan brukes til å beskrive innholdet i en fil.

    3. I de andre fanene lar jeg innstillingene stå som de er.

  5. Til slutt lagrer jeg feltinnstillingene, og blir sendt tilbake til Oppsett-oversikten.

Oppretting av felt for tekstredigering

  1. Gå til Oppsett, deretter Felter.

  2. Trykk på Legg til nytt felt.

  3. Skriv inn navn, velg TextArea som type, og skriv inn en merkelapp.

  4. Gå gjennom Detaljer.

    1. Velg CKEditor som Inputfield Type.

    2. Velg Markup/HTML som Innholdtype.

    3. Trykk deretter Lagre.

  5. Gå til fanen Inndata.

    1. Velg I linjen som Redigeringsmodus.

    2. Trykk deretter Lagre.

  6. I de andre fanene lar jeg innstillingene som stå som de er.

  7. Til slutt går jeg tilbake til Oppsett-oversikten.

Oppretting av sidemal

  1. Gå til Oppsett, deretter Maler.

  2. Trykk på Legg til ny.

  3. Skriv inn navn på malen, små bokstaver er anbefalt. Dette er malens tekniske navn.

  4. Trykk Legg til maler.

  5. Trykk deg inn i malen du nylig opprettet.

    1. Trykk på Legg til felt, og velg først filer, og så tekstomraade.

    2. Legg gjerne til en Etikett, som er malens navn utad.

    3. Trykk deretter Lagre.

    4. I de andre fanene lar jeg innstillingene stå som de er.

  6. Til slutt går jeg tilbake Oppsett-oversikten.

Oppretting av enkeltside og opplasting av PDF-fil

  1. Gå til administrasjonsgrenssnittets startside, hold markøren over websiden forside (her heter den Home) og trykk på Ny.

  2. Velg malen du nylig opprettet.

  3. Skriv inn ønsket tittel for siden.

  4. Trykk deretter Lagre.

  5. Du er nå kommet til redigeringsgrensesnittet for siden.

    1. Trykk Velg fil og hent en PDF-fil fra maskinen din.

    2. Skriv inn en beskrivelse som gjelder PDF-filen, for eksempel tittelen på filen.

    3. Skriv inn tekst i tekstområdet, og velg en del av teksten som skal lenkes opp til filen.

    4. Trykk på lenkesymbol, deretter Velg fil og så på nedtrekksmenyen hvordan du finner filnavnet på den opplastede filen.

    5. Bekreft ved å trykk Sett inn lenke.

  6. Trykk deretter Lagre.

Visning av siden

Siden vi ikke har laget en malfil i PHP tilknyttet sidemalen, så kan vi hverken forhåndsvise eller se hvordan dette blir utad enda. I dette siste punktet skal vi lage en enkel visning uten stilsett, for å se hvordan dette blir.

  1. Naviger til ProcessWire-installasjonen, deretter til mappen site og så til mappen templates.

  2. Kopier basic-page.php til en ny fil, og kall den det samme som det tekniske navnet på malen du opprettet i ProcessWire.

  3. Sett inn følgende kode i PHP-filen:

<div><?= $page->tekstomraade ?></div>

<ul>
    <?php 
        foreach ($page->filer as $item) {
            echo "<li><a href=\"{$item->url}\">{$item->get('description|filename')}</a></li>";
        }
    ?>
</ul>
  1. Gå til administrasjonsgrensesnittet i ProcessWire.

  2. Finn fram siden du opprettet, hold markøren over og trykk på Vis.