Voit itse lisätä ja muuttaa sisältöä muokkaa-painikkeiden avulla

Ennen tallennusta suositellaan ottamaan kopio muokkausruudusta (ctrl-a -> ctrl-c)

 Olet itse vastuussa tämän teoksen käytöstä aiheutuvista vahingoista Lue lisää.

Drupal

Wikikko - kansan taitopankkista
Versio hetkellä 5. helmikuuta 2019 kello 21.26 – tehnyt imported>WikikkoSysop (→‎Vinkkejä)
(ero) ← Vanhempi versio | Nykyinen versio (ero) | Uudempi versio → (ero)
Siirry navigaatioon Siirry hakuun

Yleistä[muokkaa]

Drupal on monipuolinen kotisivujen julkaisujärjestelmä joka voi laajeta isonkin yrityksen kotisivuiksi, jonka takana on laaja intra sisäiseen käyttöön. Tällä sivustolla on vinkkejä lähinnä Drupalin peruskäyttöön ja moduulien asentamiseen. Jos olet kiinnostunut tekemään omia moduuleita eli toimintoja Drupaliin, katso sivu Drupal ohjelmointi. Edellä mainitulla sivulla on myös muita vinkkejä, ehkä enemmän edistyneimmille Drupalin käyttöön.

Pikavinkkejä[muokkaa]

Drupal ongelman ratkaisu[muokkaa]

HUOM!
1) Kun Drupal kaatuu jostain syystä ja olet kirjautuneena ylläpitäjän asetuksilla, älä kirjaudu ulos!
     Ylläpitäjän oikeuksista saattaa olla apua asian selvittämisessä.
2) Ota välittömästi cPanelissa varmuuskopio tietokannasta ja drupal -hakemistosta

Seuraava lista ei välttämättä ole etenemisjärjestys, mutta voi myös olla niinkin:

  1. Älä kirjaudu ylläpidosta ulos !!!!
  2. Ota varmuuskopio tietokannasta ja tiedostojärjestelmästä
  3. Katso Raportit > Tilanneraportti virheilmoitukset
  4. Ota virheilmoitukset muistiin kuvaruutukaappauksella tai kopioimalla.
  5. Katso virheilmoitukset drupal/error_log. Osassa moduuleita voi kytkeä virheilmoitukset käyttöön TRUE.
  6. Testaa toisella selaimella toimintaa, esim. Firefox, Safari, Chrome, Explorer
  7. Tyhjennä kaikki välimuistit. Administration menu moduulilla tämä käy ylärivin pienestä logosta avautuvasta valikosta.
  8. Päivitä tietokanta
  9. Kytke virheilmoitukset päälle. Katso https://drupal.org/node/158043
  10. 15 common Drupal problems that make you scream
  11. Tyhjennä selaimen välimuistit
  12. Tyhjennä drupalin välimuisti tietokannasta
  13. Tyhjennä drupalin tiedostojärjestelmästä väliaikaiset tiedostot
  14. Tarkista tiedostojen oikeudet
  15. Kytke asentamasi moduuli(t) pois
  16. Googlaa hakusanalla drupal virheilmoitusta tai aihetta ja muutoin Googlesta
  17. Tarkista cron
  18. Tarkista base_url
  19. Tarkista settings.php
  20. Tarkista moduulin versio
  21. Tarkista jQuery versio vanhempaan
  22. Tarkista CSS tiedostojen ja java tiedostojen pakkaus
  23. Kysy drupal.org:ssa tai irc #drupal
  24. Palauta varmuuskopiosta

Drupal sanasto[muokkaa]

  • Node - sisällön perusyksikkö, sisältötyypit ovat vain erilaisia nodeja.

Peruasioita[muokkaa]

Ohjelma soveltuu hyvin kotisivujen alustaksi. Se on joustava erilaisine sisältötyyppeineen ja mahdollisuuksineen tuoda niitä esille. Drupal sisältää lukemattoman määrän erilaisia moduuleita, joilla se on laajennettavissa. Ohjelma on ilmainen. Drupalin voi melko helposti esimerkiksi rakentaa julkiseksi kotisivuksi mikä samalla ulkoasulla ja toiminnoilla toimii monipuolisena intrana esimerkiksi yrityksen tai yhdistyksen jäsenille. Käyttöoikeusrooleilla voidaan määritellä esimerkiksi artikkelitasolla kenelle kyseinen artikkeli näkyy.

  • Ohjelman rakenteen kuvausta
    • Ylläpito ja käyttäjät. Käyttöoikeuksia voidaan säätää joustavasti ja lisämoduuleilla laajentaa säätömahdollisuuksia. Käyttäjät ryhmitellään käyttäjärooleihin.
    • Drupal sijaitsee siis verkossa palvelimella ja näin kotisivujen ylläpito voidaan hoitaa vapaasti annettujen käyttöoikeuksien mukaan. Esimerkiksi sisällön kirjoittaja, sisällön julkaisija, ylläpitäjä.
    • Käännösmahdollisuudet antavat joustavasti muuttaa sivuston toiselle kielelle ja myös kääntää luotua sisältöä. Esimerkiksi suomenkielelle ohjelmisto ja moduuleja on käännetty laajasti. Tietokantaan kääntäminen on helppoa, jos jokin valmis teksti ei miellytä.
    • Sisältöä luodaan sisältötyyppeihin, joita näytetään eri tavoin: blogina (blog), foorumina (forum), kirjana (book), kyselynä (webform), äänestyksenä (poll), perussivuna (page), artikkelina (article), syötteenä (feed)
    • Drupalin ydintä laajennetaan moduuleilla, joita löytää pääasiassa drupal.org -sivustosta. Tietyllätavoin minuksena voidaan pitää että esimerkiksi versio 7 ei sisällä monia hyödyllisiä moduuleita joita nykyajan nettisivulla kuuluu olla. Vaikka Drupal on yksinkertainen asentaa moduulien asentamiseen kuluu aikaa. Usea moduuli vaatii säätämistä ja sen lisäksi "ymmärtämystä" miten sitä käytetään. Käyttöä helpottaa myöhemmin kun hahmottaa Drupalin toimintaperiaatteen eli valikot, lohkot, sisältötyypit, käyttöoikeudet ja niiden keskinäisen riippuvuuden ja toiminnan.
    • Ulkoasua vaihdetaan teemoilla, joita on ilmaiseksi saatavilla.
    • www.drupal.org -sivusto sisältää valtavasti tietoa ohjelmasta.

Ohjeita[muokkaa]

Asennus[muokkaa]

Katso tarvittaessa myös alkuosaa sivusta Drupal ohjelmointi.

cPanel[muokkaa]

Katso onko cPanelissa Softaculous asennusohjelma, jonka valikoimasta voi löytyä Drupal 7 tai 8.

Drupal 8 alpha 8[muokkaa]

Mavericks (Mac OS X)[muokkaa]

  • Seuraa Drupal 8 asennusta muutoin, mutta huomioi seuraavat:
    • asennusohjeet löytyvät hakemistosta core/INSTALL.txt
    • Jos käytät muuta kieltä kuin englanti, asennusohjelma lataa Drupalin palvelimelta kyseisen kielitiedoston. Tätä varten tarvitsee antaa /sites/default hakemistoon kirjoitusoikeus, johon asennusohjelma lisää hakemistot /files/translations. chmod a+w sites/default lisää kirjoitusoikeuden. Muista poistaa kirjoitusoikeus asennuksen jälkeen komennolla chmod go-w sites/default
    • Kopioi myös /sites/default/default.settings.php -tiedosto hakemistoon /sites/default/settings.php ja anna siihen oikeudet chmod a+w settings.php Asennuksen jälkeen muista poistaa kirjoitusoikeus chmod go-w sites settings.php
    • Muista poistaa kirjoitusoikeudet kuten aiemmin mainittiin jos sivusto näin ilmoittaa, koska silloin ei ole itse voinut niitä muuttaa.
  • Asennuksessa saattaa ilmetä heti jokin outo virhe, joka ilmoittaa että index.php ei löydy. Tämä poistui itsestään tekemättä mitään, vaan palaamalla ainoastaan aikaisemmalle sivuille selaimen paluunäppäimellä ja antamalla osoite http://localhost/~esa/drupal8/index.php

Drupal 7[muokkaa]

Mavericks (Mac OS X)[muokkaa]

  • Ota käyttöön Apache, PHP ja Mysql, Wikikossa näiden asennuksesta on sivulla PHP.
  • Voit tehdä lataukset, tiedoston purkamisen ja uudet kansiot Finder ohjelmalla tai päätteessä. Tiedosto-oikeudet lienee helpoin muuttaa päätteessä.
  • Tehdään drupalille kansio ~/Sites -hakemistoon.
Jos teet päätteellä:
mkdir ~/Sites/drupalkansionnimi
cd ~/Sites/drupal/
  • Ladataan Drupal sivustosta drupal.org. Tällä hetkellä suositeltavat versioit ovat 7-alkuisia.
Jos teet päätteellä:
curl -O http://ftp.drupal.org/files/projects/drupal-7.26.tar.gz
tar -xvzf drupal-7.26.tar.gz
mv drupal-7.24/* .
mv drupal-7.24/.* . 
rm -rf drupal-*
  • Siirretään settings.php
Jos teet päätteellä:
cp ~/Sites/drupal/sites/default/default.settings.php ~/Sites/drupal/sites/default/settings.php
  • Muutetaan tiedosto-oikeuksia
chmod -R a+w ~/Sites/drupal/sites/default
  • Kytke päälle MySQL viimeistään nyt. Voit luoda tietokannan pääteohjelmalla tai phpMyAdmin ohjelman kautta. Jos käytät jotain olemassaolevaa tietokantaa, ainakin Drupal 8 asennuksessa voit määritellä etuliitteen tauluille.
mysql -utietokantakäyttäjätunnus -psalasana -e "create database tietokannannimi;"
  • Asenna Drupal Standard asetuksilla (tai Minimal)
http://localhost/~käyttäjänimi/drupalkansionnimi/
  • Lopuksi anna OS X käyttäjätunnustasi apunakäyttäen
sudo chown -R käyttäjänimesi ~/Sites/drupal
  • Rajoita oikeuksia hakemistoon sites/default ja tiedostoon sites/default/settings.php. Katso lisätietoa kohdasta Drupal 8 asennuksen kohdasta.

Lähde: http://www.coolestguidesontheplanet.com/downtown/fastest-way-of-installing-drupal-7-on-mac-os-x

Päivitys[muokkaa]

Uudempaan Drupal-versioon päivittäminen tapahtuu lataamalla core-hakemistot ja tarvittaessa .htaccess ja aja update.php. Katso tarkemmin kohdasta Turvallisuus.

Moduulien asennus kotikoneella[muokkaa]

Mahdollisesti yrittäessäsi asentaa moduuleita "kotitietokoneella" eli paikallisella koneella, saat virheilmoituksen Cannot connect to FTP Server, check settings. Ratkaisu on kopioida moduulit suoraan kansioon sites/all/modules ja kytkeä ne päälle normaalisti. Kyse on siitä että yrität käyttää FTP yhteyttä siirtämään tiedostoja omassa tietokoneessa :-)

Olemassaolevan Drupal sivuston siirtäminen[muokkaa]

Katso sivulla Drupal ohjelmointi

Moduulit[muokkaa]

Moduulit asennetaan sen versionumeron mukaan, joka Drupal on. Ainakin ensimmäinen versionumero, esimerkiksi 7 pitää osua kohdalleen. Betaversiot ovat epävakaampia, joten niihin on suhtauduttava varauksella jos ohjelmointitaitoja ei ole. Moduuleita asennettaessa suositellaan ottamaan tietokannasta varmuuskopio ja käyttämään mielellään toista drupal -asennusta, jossa aluksi moduulia voi testata ennen kuin sen asentaa varsinaiseen käyttöversioon.

  • HUOM! Se ylläpitäjän tunnus jolla asensit Drupalin on käyttöoikeusiltaan laajempi kuin myöhemmin tällä myönnetyt ylläpitotunnukset. Jos et esimerkiksi pääse jonkin moduulin asetuksiin, niin kirjaudu ensimmäisellä ylläpitotunnuksella sisään. Huomaa että Drupal 6 versiossa purettu moduuli kansio ladataan site/default/modules -kansioon, kun versiosta 7 lähtien latauksen voi tehdä sivuston moduulit -sivun kautta.

Moduulin asennus etenee yleensä seuraavasti:

1) Luetaan viimeistään moduulin asennus ja ohjeita. Katso miten moduulia päivitetään ja milloin on päivitetty esimerkiksi viimeksi. Tarvittaessa etsitään lisätietoa googlesta. Haun alkuun kannattaa kirjoittaa sana drupal

2) Ladataan moduuli drupalin sivuilta pakattuna esimerkiksi omalle tietokoneelle. Anna tiedoston olla zip-pakattuna.

3) Otetaan mielellään varmuuskopio tietokannasta tai ainakin tiedostetaan riski

4) Lisätään Drupalissa moduuli kohdasta Asenna uusi moduuli.

5) Kytketään moduuli päälle ja samalla saadaan viimeistään selville tarvitseeko moduuli muita moduuleita ja tarvitsevatko nämä vielä lisää moduuleita. Asennetaan tarvittaessa kaikki moduulit.

6) Ajetaan tietokannan päivitys eli update.php. Saattaa olla että sivusto ei aukea ollenkaan tai toimi oikein jos tietokantaa ei päivitetä!

7) Asetetaan moduulille tarvittaessa käyttöoikeudet

8) Osassa moduuleita on asetuksia jotkä täytyy määritellä.

9) Selvitetään miten moduuli saadaan esille. Se saattaa vaatia kytkemisen valikossa tai lohkoissa tai se saattaa näkyä sisällön välilehdessä.

10) Etsitään ohjeita Googlesta kun homma ei toimi. Yleensä Drupal.org foorumista löytyy ratkaisu tai kysytään ircissä #drupal

Moduulien päivittäminen[muokkaa]

Päivitys sijaitsee Raportit / Saatavilla olevat päivitykset / Päivitä-välilehti. Välilehteä ei välttämättä näy jos siinä päällä on oikopolut-palkki! Muista tietokannan päivitys!

  • Päivitykseen saattaa aina liittyä tietokannan päivitystä, joten tietokannan päivitys on ajettava AINA. Tämä on automatisoitu, joten seuraat vain ohjeita.
  • Kannattaa päivittää yksi moduuli kerrallaan ja ajaa heti jokaisen moduulin perään tietokannan päivitys ja katsoa toimiiko sivusto. Tällä tavoin voi huomata, mikä päivitys mahdollisesti kaataa koko sivuston, eikä tarvitse selvittää mahdollisesti mikä moduuli kaatumisen aiheuttaa.

Moduulien päivittäminen - patch[muokkaa]

Patch-tiedosto on tideosto joka sisältää ohjelmakoodia jolla olemassaolevia tiedostoja voidaan muokata. Tiedosto siis sisältää esimerkiksi jonkin korjauksen tai toiminnon joka puuttuu esimerkiksi moduulista. Tiedosto sisältää myös ohjeita jotta unixin patch -komento osaa suorittaa muutokset komentoriviltä. Patch toimii myös linux palvelimilla. Patch on yleisesti ohjelmistojen käytössä ja siis myös Drupal käyttää sitä. Normaalisti muutoksia tehdään moduuleihin, rivillä + tarkoittaa lisättävää riviä ja - poistettavaa

  • Nouda .patch -tiedosto. Varmista että se on kommenteissa todettu toimivaksi ja on sopiva sinun moduuliisi.
  • Varmuuskopioi tietokanta
  • Varmuuskopioi kyseinen moduulikansio tai tiedostot joita patch muuttaa, ne näkyvät --- ja +++ kohdissa tiedostossa
  • Tallenna .patch -tiedosto moduulin hakemistoon
  • Avaa Pääte ja muodosta yhteys palvelimeen > siirry kyseiseen hakemistoon
  • Testaa komennolla, mikä ei vielä tee mitään muutoksia: patch -p0 --dry-run < tiedostonimi.patch
    • Jos tulostaa esimerkiksi vain muutettavat tiedostot homma toimii: patching file tiedosto.info
    • Jos tulostaa esimerkiksi can't find file to patch at input line 5 niin tarkista onko polku oikein esm. a/tiedostonimi.info niin poista a/
  • Käytä VAIN jompaa kumpaa seuraavista. -b tekee varmuuskopiot alkuperäisistä.
patch -p0 -b < tiedostonimi.patch
patch -p0 < tiedostonimi.patch
  • Tuloksena esimerkiksi: patching file tiedosto.info ja muutokset on suoritettu.
    • Jos tulostaa esimerkiksi Hunk #2 FAILED at 100. kyseessä on ymmärrettävästi virhe. Tällöin #2 tarkoittaa toista tiedostoa? ja 100 rivinumeroa
  • Tarvittaessa voit tarkistaa onko patch-tiedostossa + merkittyjä rivejä tullut kyseisiin tiedostoihin.
  • Ei update.php eli tietokantaa ei tarvitse päivittää
  • Tarkista että sivusto toimii normaalisti ja muuttuiko se mitä yritit
    • Tarvittaessa tyhjennä välimuisti
  • Jos on tarve palauttaa tilanteeseen ennen patchausta, anna komento patch -p0 -R < tiedostonimi.patch TAI jos teit -b komennolla varmuuskopiot, tuhoa muutetut ja muuta varmuuskopioiden nimet alkuperäisiksi.
    • Tarvittaessa tyhjennä välimuisti ja jos tietokanta sekosi, palauta tietokanta.


https://drupal.org/node/620014
https://drupal.org/patch/apply
https://drupal.org/node/534548

Moduulien poistaminen[muokkaa]

  • Poista rasti ja Tallenna. Huomioi riippuvaisuudet, esimerkiksi mikä moduuli vaatii kyseistä moduulia toimiakseen.
  • Aennuksen poisto välilehdeltä moduuli voidaan poistaa tietokannasta
  • Jos moduuli halutaan moduulit -listalta pois, se on käsin poistettava tiedostojärjestelmästä /drupal/sites/all/modules/moduulin kansion nimi
    • HUOM! Jos vain muutat moduulihakemiston nimeä /sites/all/modules -hakemistossa, se näkyy kuitenkin moduuleissa.
    • Moduulit löytyvät tietokannan taulusta system johon voit kohdistaa phpMyAdmin -ohjelmalla Etsi-toiminnon hakemalle name kohdassa moduulin nimellä.

Chatblock[muokkaa]

Jos jossain teemassa syöttöruutu jää hyvin pieneksi, kokeile muuttaa chatblock css-tiedoston rivi: height: 2.25em; ja katso kohta css-tiedostot tältä sivulta että saat ajettua tarvittaessa uuden css-tiedoston, jolloin muutos vasta tulee sivulla näkyviin.

Facebook[muokkaa]

Kirjautuminen Facebook tunnuksilla[muokkaa]

Simple FB Connect 7.x-2.x asennettu 14.8.2015

  • Huomaa että verstio 2 vaatii php 5.4 palvelimella. Esm. Sitegroundissa sen voi asettaa Cpanelissa käyttöön vain tietylle kansiolle. Tarkistetaan: php -v
  • X Autoload moduulin asennus onnistuu helposti. Libraries API oli jo ennestään asennettu.
  • Facebook PHP SDK version 4.0.23 asennus ei onnistu normaalisti moduulin asennuksella koska herjaa .info -tiedoston puuttumisesta. Asenna pääteohjelmalla seuraavasti:
cd sites/all/libraries/
wget https://github.com/facebook/facebook-php-sdk-v4/archive/4.0.23.tar.gz
mv 4.0.23 4.0.23.tar.gz
tar -xvf 4.0.23.tar.gz
mv facebook-php-sdk-v4-4.0.23/ facebook-php-sdk-v4
  • Luo Facebookissa sivulla https://developers.facebook.com/apps sivustolla Applikaatio. Siirrä Facebookista moduuliin App ID ja App Secret ja moduulista Facebookiin Site URL kohtaan Settings Facebookissa.
    • Ota appi käyttöön Facebookin kohdassa Status & Review
    • Facebookin kohdassa Settings > Advanced jos valitset Is App Secret embedded in the client, niin kirjautuminen ei välttämättä onnistu.
  • Suora kirjautumisosoite on /user/simple-fb-connect
  • Voit lisätä esimerkiksi kirjautumispainikkeen etusivulle tekemällä otsikottoman lohkon ja lisäämällä kuvakkeen lohkon sisältöön linkillä <muu> /user/simple-fb-connect
  • Voit myös Facebookissa luoda kirjautumispainikkeen, joka näyttää esimerkiksi kavereita linkin vieressä. Tämä vaatii koodien lisäämistä sivupohjiin tms.
  • Facebook -käyttäjän sähköpostiosoite pitää siis olla sama kuin käyttäjän sähköpostiosoite Drupalissa. Jos olet Facebook-sähköpostiosoitteella Drupalissa ylläpitäjä, tämä voi olla asetuksissa turvallisuussyistä estetty eli FB tunnuksilla ei suositella kirjautumista ylläpitäjänä.
  • Kirjautuvalla pitää olla myös sallittu rooli.

Flag[muokkaa]

Flag -moduulilla voi esimerkiksi asettaa käyttäjille omat kirjanmerkit mahdollisuuden. Moduuli on hyvin monipuolinen ja sen ominaisuudet tulevat esille lähennä Views -moduulin avulla jolla tulokset saadaan näkyville. Kirjanmerkit asettuu valmiiksi Views-moduuliin. Flag moduulilla voi esimerkiksi tehdä painikkeen sivulle, jossa käyttäjät klikkaavat lukeneensa jonkin sivun.

https://drupal.org/documentation/modules/flag

JavaScript callback handler[muokkaa]

  • js module voi vaatia päivityksen jälkeen juurihakemiston .htaccess tiedostoon uudestaan koodin lisäämisen. Uusi koodi löytyy kohdasta Asetukset > JS Callback handler. Aseta koodi .htaccess noin riville 59 eli heti RewriteEngine on -kohdan jälkeen.
  • jQueryn päivitys kohdassa Raportit > Tilanneraportti > jQuery Update > configure
    • Drupal 7 versiossa käytä 1.7 -versiota. Kun muutat tyhjennä välimuisti.

Localization client[muokkaa]

Kun käännät Drupalia esimerkiksi suomeksi ja olet jo ladannut suomenkielisen kielipaketin käyttöösi, pysähdy hetkeksi miettimään että käytät muiden vapaaehtoistyönä ja avuliaisuuttaan sinua kohtaan kääntämiä käännöksiä. Hyvä tapa on antaa omaa aikaansa myös muille ja laittaa tämä hyvä kiertämään. Lataamalla Localization client ohjelman ja luomalla käyttäjätilin drupal.org sivuille saat lyhyen tunnistekoodin, jonka syötät tähän moduuliin sivuillasi. Tämän jälkeen sivun alareunaan ilmestyy ylläpidon puolella pieni Käännä painike, josta painamalla saat aina kyseisen sivun käännökset aukeamaan sivun alaosaan ja voit tehdä käännöksen välittömästi. Käännöksesi tulee heti omille sivuillle näkyviin kun lataat sivun uudestaan ja se myös lähetetään drupalin kotisivuille, joissa suomalaiset käännösmoderaattorit tarkastavat ne ja todennäköisesti hyväksyvät ne muille jaettavaksi. Lisäohjeita

Media[muokkaa]

  • Virheilmoitus päivitettäessä tietokantaa: Unresolved dependency file_entity (Missing) Media requires this module.
    • Asenna ja ota käyttöön Field Entity -moduuli 7.x-2.0-beta3 tai uudempi. Lataa uudelleen tietokannan päivityssivu.

Printer, email and PDF versions[muokkaa]

  • PDF-tulostukseen valitse dompdf library handler, PDF version, Printer-friendly pages, Printer-friendly pages UI
  • Virhe Sivustolla tapahtui odottamaton virhe. Yritä myöhemmin uudelleen.
  • Dompdf-ilmoituksen kytkeminen tilanneraportista pois settings.php-tiedostossa, lisää rivi $conf['print_pdf_dompdf_secure_06'] = TRUE;

Support[muokkaa]

Luo sivustoon tiketti järjestelmän johon voi lisätä tehtäviä ja kuka niitä hoitaa. Integroitu sähköpostiin ja graafinen seurantamahdollisuus. Monipuolinen moduuli. Tärkeys ja tila ovat muutettavissa suomenkieliseksi tietokannassa tauluissa support_priority ja support_states. Esimerkiksi uusi, työn alla, lähes valmis, suljettu ja matala, normaali, korkea, kriittinen

Topbar Messages[muokkaa]

Moduulilla voi lisätä sivun ylälaitaan ilmestyvän bannerin jossa voi ilmoittaa tekstiä ja linkin. Huomaa että banneri ilmestyy aina sivua avatessa. Jos säädät moduulin asetuksissa 0 sekuntia, niin banneri ei avaudu vaan näkyvissä on ainostaan läpyskä josta sen voi avata. Lisäksi ilmoitus ei näytä ilmeisesti huomioivan nodeaccess -moduulin oikeuksia vaan näkyy kaikille. Katso myös tältä sivulta miten se voidaan toteuttaa Views -moduulilla.

  • Asetukset, joissa palkin, tekstin ja linkin väriä sekä automaattisen sulkeutumisen aikaa voi muuttaa löytyy /admin/config/system/topmessage
    • Jos sivu ei aukea, kirjaudu Drupaliin sillä ylläpidon käyttäjätunnuksella jolla asensit koko Drupal ohjelmiston.
  • Jos moduuli ei toimi saattaa syynä olla että Drupalin asetusten suorituskyky kohdassa ei ole valittuna Tiivistä Javascript tiedostot.
  • Englannin kielisen tyhjän ilmoituksen tekstin voi muuttaa moduulin tiedostokansiossa tiedostossa topbar_msg.module riveillä 67
  • Läpyskän Close ja Open sanat voi muuttaa topbar_msg.js riveillä 10 ja 12. Huomaa että tämän jälkeen Suorituskyky asetuksissa on klikattava pois päältä Tiivistä Javascript tiedostot, Tallenna asetukset, Tyhjennä välimuistit ja kytkeä takaisin Tiivistä Javascript tiedostot päälle jotta muutos tulee näkyviin.

Wysiwyg[muokkaa]

Oletuksena Drupal ei sisällä mitään Word-näköistä tekstieditoria. Vaihtoehtoja on useita, mutta niiden pohjaksi asennetaan Wysiwyg -moduuli. Editorien asentaminen voi ajottain olla raastavaa, joten seuraavista vinkeistä voi olla hyötyä ongelmaa etsiessä.

  • Asenna Wysiwyg moduuli normaalisti, jonka jälkeen asetuksissa on kohta jossa on lueteltu tuetut editorit. Lataa normaalisti haluamasi editori, esimerkiksi CKEditor tai Tinymce linkistä joka sivulta löytyy. Suositeltavaa on ladata uusin, mutta jos et saa sitä toimimaan drupal-versiosi kanssa, kokeile vanhempaa.
  • On tärkeää että asennat editorin juuri siihen hakemistopolkuun joka on sivun ohjeessa neuvottu. esimerkiksi sites/all/libraries/tinymce
  • Lataa nyt uudestaan wysiwyg-asetussivu ja editorin pitäisi automaattisesti asentua ja antaa valita syöttömuodot (esm. Full HTML) kohtaan kyseinen editori. Jos ohjeessa näkyy yhä Not installed, on editori väärässä hakemistossa. Jos se kohta muuttuu punaiseksi tms. editori ei ole asentunut oikein, kokeile esimerkiksi vanhempaa versiota. Onnistunut asennus on vihreä ja näyttää versionumeron.
  • Muokkaa syöttötyyppiä, jokaiselle syöttötyypille täytyy asentaa omat asetukset.
    • Älä muuta kieltä suomeksi vaan pidä se englantina. Saattaa olla että editori ei näy suomenkielisenä ollenkaan. Kun saat editorin ensin näkymään, voit sitten kokeilla eri asetuksia.
    • Editorille pitää valita painikkeet.
    • Kuvat saa käyttöön valitsemalla Image ja IMCE -painikkeet ja asennettuna pitää olla moduuli IMCE Wysiwyg bridge. Aseta asetuksissa kohdassa IMCE käyttärooleille tiedostoprofiilit ja määritä profiilissa mitä kansioita kukin saa käyttää.
    • CSS kohdassa kannattaa ehkä valita kohdassa Editor CSS: Editor default CSS. Jos käytät sivuston omia, saattaa esimerkiksi editorin tekstilaatikon tausta olla muu kuin valkoinen.
  • Kokeile muokata jotain sivua, katso että syöttömuoto on sellainen johon olet asettanut edelliset asetukset. Editori ei näy kuin niillä syöttömuodoilla jotka on edellä kuvatusti asetettu.
  • Jos et näe editoria, voit kokeilla esimerkiksi näkyykö Drupalin teemassa garland tai lisää oman teemasi page.tpl.php tiedostoon seuraava rivi ennen riviä </body>
<?php print $closure ?>

FCKeditor[muokkaa]

Drupal ohjelman yhteydessä käytettävä FCKeditor asentaminen saattaa tuottaa päänvaivaa. Readme.txt ohjeita huolellisesti seuraamalla kyllä saa hakemistot oikein eli fckeditor hakemistot sisäkkäin moduuli hakemistoon, josta mm. englanninkielinen ohje sivulla http://drupal.org/node/113056 Mutta vaikka kaikki on oikein, saattaa olla että editori ei aukea...

Ratkaisumahdollisuus 1[muokkaa]

Jos olet käyttänyt esimerkiksi aiempaa Drupal versiota ja siirrät aikaisemman Teeman sieltä (olet esimerkiksi muokannut sitä omanlaiseksi) niin teemahakemiston page.tpl.php tiedostoon pitää lisätä rivi

<?php print $scripts ?>

Tämä lisätän <head> tagien väliin:

<head>
<title><?php print $head_title ?></title>
<meta http-equiv="Content-Style-Type" content="text/css" />
<?php print $head ?>
<?php print $styles ?>
<?php print $scripts ?>
</head>

CKEditor[muokkaa]

Katso yleiset asennusohjeet yläpuolelta.

  • Jos saat virheilmoituksen: "Notice: Undefined offset: 2 in wysiwyg_ckeditor_version() (line 85 of /my/path/sites/all/modules/wysiwyg/editors/ckeditor.inc).: muokkaa rivi 81 seuraavaksi /drupal/sites/all/modules/wysiwyg/editors
if (preg_match('@version:[\"|\'](?:CKEditor )?([\d\.]+)(?:.+revision:[\"|\']([\da-z]+))?@', $line, $version)) {
  • Jos editori ei tule näkyviin voit kokeilla asentaa kama -skinin. Hakemistoon /drupal/sites/all/libraries/ckeditor/skins/kama Hae hakemiston sisältö osoitteesta http://ckeditor.com/addon/kama

Tinymce[muokkaa]

Katso yleiset asennusohjeet yläpuolelta.

  • Drupal 6 versiossa jos versio 4 ei toimi, kokeile versiota 3 joka ainakin on mahdollista saada toimimaan.

Views, node ja sisältötyypit[muokkaa]

Aloittelevalle Drupalistille saattaa tuottaa vaikeuksia ymmärtää miten Drupal rakentuu ja miten sen sisältöä käsitellään. Kuvailen tässä lyhyesti miten asiaa voisi ymmärtää. Sisältötyypeiksi määritellään yleensä esimerkiksi artikkeli (uutinen), kirja (kuin kirja), foorumi (keskustelupalstan kirjoitus), sivu (staattisempi tietosivu). Tämän lisäksi käyttäjä voi itse luoda omia sisältötyyppejä. Tästä esimerkkinä ohessa, tehtävälistäsyöte. Node on perusyksikkö, jokin tällainen syöttötyypillä luotu kirjoitus. Näitä voidaan sitten eri tavoin näyttää. Näyttämiseen on erilaisia moduuleita ja näistä yksi on Views -moduuli. Tämän moduulin avulla voi syöttötyypeistä poimia haluamansa ja suodatella niistä sopivia ja näyttää sisältöruudussa tai lohkoissa. Tästä esimerkki ohessa.

https://drupal.org/node/1911062
https://drupal.org/node/296954

Esimerkkinä muistutus eli tehtävälista[muokkaa]

Tehdään tehtävälista, jossa määritellään uusi syöttötyyppi ja Views -mooduulilla näytetään lista. Tämä esimerkki on lyhyt kuvaus mahdollisuuksista.

  • Lisätään uusi sisältötyyppi nimellä Muistutus ja säädetään sille oletusasetukset.
  • Siirrytään sisältötyypin kenttiin. Kenttiä voi luoda vapaasti liittyen siihen mitä tietoa kuhunkin sisältötyyppiin haluaa käyttäjiltä sisällytettävän. "Muistutus nimi" on tehtävälistan tuleva rivi. Lisäksi voisi olla esimerkiksi Tila, Kohde ja tehtävän kuvaus. Lisäksi esimerkiksi viimeistään valmis, tärkeys
    • Tila -kentällä tehtävä merkitään valmiiksi. Kentän tyypiksi valitaan totuusarvo ja yksittäinen valintaruutu. Päälle arvoksi merkitään Valmis ja pois päältä arvoksi Listalla.
    • Kohde -kentällä tehtävä merkitään haluttuun tehtävälistaan. Listoja voi siis olla useampia ja ne voidaan Views -moduulilla näyttää kaikki samalla listalla tai eri listoilla. Jos haluat vain yhden listan, tätä toki ei silloin tarvita.
    • Tehtävän kuvaus antaa mahdollisuuden antaa tehtävästä laajempaa kuvausta. Tässä voidaan käyttää valmista body -kenttää. Onhan kyseessä Node, joten vaikka tehtävälista näyttäisi ulospäin vain tehtävän nimen, voi se sisältää kenttinä tekstiä, kuvia, tiedostoja yms. Jos käytät vain pelkkää otsikkoa, poista body kenttä kokonaan. En ole kokeillut body kentän kanssa tämän ohjeen toimivuutta.
    • Jostain syystä syöttötyypin otsikoksi tulee koneluettavana nimenä "title" ja tämä sekoittuu tällöin kaikkii muihinkin nodeihin. Olen myös saanut sen asentumaan toisinkin. Jos kuitenkin koneluettava nimi on "title", niin lisää kenttä "tehtäväluettelosyote" ja määritä se tekstiksi ja lisää siihen esimerkiksi vakiteksti: tehtavaluettelosyote Myöhemmin Views -toiminnolla voit suodattaa ne nodet tehtävälistaan, jotka sisältävät tämän tekstin.
  • Siirry Views -moduuliin, joka sijaitsee Rakenne valikossa. Lisää uusi näkymä. Voit lisätä esimerkiksi sivun tai lohkon. Lisätään tässä sivu.
    • Anna tarvittavat tiedot: mm. aseta muodoksi taulukko ja aseta valikkolinkki. Tallennuksen jälkeen eteesi avautuu sivu, jossa on kolme saraketta. Voit tehdä lukuisia valintoja siitä mitä näytät ja miten näytät.
    • Kohdassa Kentät valitset mitä kenttiä käytetään. Valitse kentät: Sisältö: Otsikko, Tila (Tila). Ja säädä tarvittavat asetukset. Nämä siis
    • Kohdassa Suodatinkriteerit valitset milloin oheisten kenttien tietoa näytetään. Valitse Sisältö: Julkaistu (Kyllä), Tehtäväluettelosyöte (=tehtavaluettelosyote), Tila (=Listalla)
      • Tehtäväluettelosyöte -kohdassa valitse operaattoriksi On yhtä kuin tehtavaluettelosyote
      • Tila -kohdassa valitse operaattoriksi On yksi ja valinnaksi Listalla
      • Lisää myös muut kentät jotka haluat tuoda sivulla esiin. Huomaa että jos liität esimerkiksi otsikkorivin linkiksi nodeen, voit siellä esittää kaiken muun.
    • Taulukko -kohdassa voit valita haluamiesi sarakkeiden otsikot lajiteltaviksi, jolloin tehtäviä voi luettelossa lajitella eri tavoin.
    • Sivuasetuksissa voit säätää tarvittaessa valikkolinkkiä.
  • Jos haluat tehdä tehtävälistasta Lohkon tee kyseiset säädöt lohkolle. Ruudun yläreunassa on +Lisää , josta voit lisätä lohkon jos et valinnut luotavaksi sitä jo aivan aluksi aloittaessasi uuden näkymän luontia.
  • Voit seurata ruudun alareunassa esikatselussa miten asetuksesi vaikuttavat näytettävään sisältöön.
  • Huomaa että vasta tallenna -painike tallentaa asetukset.
  • Kytke Käyttäjät-valikon kautta käyttöoikeudet moduulille.
  • Jos käytät esimerkiksi Nodeaccess -moduulia, säädä myös siellä uudelle syöttötyypille käyttöoikeudet.
  • Tehtävälistan pitäisi nyt tulla sivuna näkyviin, kun painat valikon linkkiä tai kirjoitat selaimen osoiteriville antamasi polun osoitteen kohdassa sivuasetukset.

Ohje on sivulta http://www.drupalgardens.com/content/how-do-todo-list

Ilmoituslaatikko[muokkaa]

Kotisivuilla näkee ajoittain värillisiä laatikoita jotka voivat sisältää esimerkiksi jonkin ilmoituksen. Sellaisen voi toteuttaa myös Views moduulilla.

  • Perusta uusi syttötyyppi joka sisältää ainoastaan otsikon ja sisällön. Aseta näkymävalinnoissa vain sisältö ja otsikko.
  • Luo tähän syöttötyyppiin sisältö ja aseta se näkyviin niin näet sen näkymää perustaessasi sen esikatselussa.
  • Perusta uusi näkymä nimellä ilmoituslaatikko, lohko. Aseta se näyttämään kyseinen syöttötyyppi
  • Aseta lohko näkymään sisällössä ja vain etusivulla ja vedä se sisältöjen ylimmäksi järjestyksessä.
  • Muokkaa käyttämäsi teeman style.css tiedostoa asettamalla sinne seuraava tyyli. Lisää ohjeita aiheesta http://views-help.doc.logrus.com/help/views/theme-css
/*-------------------------------------------*
/* Ilmoituslaatikko
/*-------------------------------------------*/
.view-ilmoituslaatikko div {
  background: yellow;
}
    • Asetukset/Kehitys/Suorituskyky kohdassa poista raksi Tiivistä ja pakkaa CSS tiedostot > Tallenna asetukset > lisää raksi Tiivistä ja pakkaa CSS tiedostot > Tallenna asetukset jolloin css tiedostoon tehty muutos tulee voimaan.

Kalenteri[muokkaa]

Calendar ja iCal moduulien asentaminen syötteineen vaatii paljon muita moduuleita. Jos haluat yksinkertaisesti ottaa käyttöön esimerkiksi Google-kalenterin lisää perussivulle googlekalenterin asetukisista, kalenterin tiedoista, kohdasta upota tämä kalenteri koodi. Tarvittaessa muokkaa kalenterinäkymää ensin Googlessa. Kytke drupalin editorsta rich-text pois päältä, mutta jätä Full HTML ja lisää kyseinen koodi. Kalenterille voit antaa suoran url-osoitteen ja se on muokattavissa googlen kautta. Googlessa voit määrittää esimerkiksi ketkä googletilin omaavat käyttäjät voivat kalenteria muokata.

  • iCalcerator asentamisessa katso että iCalcreator.class.php -tiedosto todella sisältää php -koodin.

Kielet[muokkaa]

Huom! Seuraava ohje epäselvä, tarvitaanko Language Swithcer -moduulia ollenkaan?

  • Language Switcher -moduulin avulla sivuston voi kääntää eri kielille. Tämä on myös näppärä toiminto kun etsit kysymyksiisi vastauksia internetistä, käytät suomen kielistä käännöstä, mutta tarviset englanninkielisen hakusanan.
  • Klikkaa myös moduulit Locale ja Content translation -ydinmoduuleista päälle. Jos moduuli ei tule näkyviin aseta Ylläpito/Asetukset/Alue ja kieli/Kielet ja välilehdestä automaattinen asettaminen ja valitseminen käyttöön kohta URL eli "Määrittele kieli osoitteen perusteela (polun etuliite tai domain)". Aseta tämän painoarvoksi vielä pienin luku että se on listan ylimpänä.
  • Lohkoissa valitse Kielen valitsin (Käyttöliittymän teksti) tai Language switcher dropdown (Käyttöliittymän teksti)
  • Alkuperäisen kielen etusivun kun kääntää muille kielille, pitää muistaa jokaisen käännetyn etusivun valinnoista asettaa päälle julkaisuasetuksissa "näytetään etusivulla".
  • Jos et pysty kääntämään valikon kohtia toiselle kielelle ja saat virheilmoituksen: Sinulla ei ole käyttöoikeuksia tälle sivulle. tai englanniksi You are not authorized to access this page. Tarkista että kohdassa Rakenne/valikkosi/muokkaa valikkoa on valittuna kohta Käännä ja lokalisoi.

Kuvakansiot[muokkaa]

Esimerkiksi IMCE mahdollistaa käyttäjille henkilökohtaiset kuvakansiot ja lisäksi voidaan määritellä esimerkiksi yhteisiä kuvakansioita.

  • IMCE asentaminen näkyviin esimerkiksi CKEditorin kanssa vaatii IMCE Wysiwyg bridge -moduulin asentamisen. Tämän jälkeen kohtaan Asetukset/Sisällön luonti/Wysiwyg profiles/Full HTML/Buttons and plugins ilmestyy IMCE -napin valintamahdollisuus.

Käyttöoikeudet[muokkaa]

Drupalin käyttöoikeuksissa määrität mitkä roolit saavat käyttää miten sivustoa. Niissä ei kuitenkaan päästä tarkemmin määrittelemään mitkä nodet näkyvät kenellekin. Yksittäiselle käyttäjälle tai roolille. Tähän soveltuu esimerkiksi moduuli Nodeaccess, jolla voit säätää em. näkyvyyttä. Kullekin sisältötyypille määritetään kullekin roolille sisällön näkyvyys, sisällön muokkaus ja mahdollisuus poistaa sisältö. Lisäksi sisällön kirjoittaja voi tehdä oikeuden määrityksiä. Esimerkiksi käyttäjä päättää että tämä kirjoitus on tarkoitettu vain tiettyyn rooliin kuuluville luettavaksi. Käyttöoikeuksia säädettäessä voi syntyä päällekkäisyyksiä, jolloin moduuleissa saattaa olla mahdollisuus määrittää mitkä käyttöoikeudet ovat ne joita käytetään.

Settings.php[muokkaa]

Poista risuaita (#) seuraavan rivin edestä ja vaihda se drupal-hakemistosi osoitteeksi, esimerkiksi $base_url = 'http://www.omadomain.fi/drupal'; // NO trailing slash!

Virheilmoituksia ja bugeja[muokkaa]

  • Odottamaton virhe. Sivusto ei enää toimi
    • Oletko päivittänyt moduulin, mutta et ole ajanut tietokannan päivitystä? Saattaa olla että esimerkiksi tietokanta ei ole ajan tasalla ja sivusto ei aukea. Päivitä tietokanta eli update.php tiedoston ajaminen.
  • Notice: Undefined index: localized_options in menu_navigation_links() (line 1860 of /home/user/public_html/includes/menu.inc
    • Oletko vaihtanut Rakenne/Valikot/Asetukset -kohdassa Toissijaisen linkkien lähteen? Aseta takaisin esimerkiksi User
  • Lisää sisältöä -luetteloon ei ilmesty sisältötyypeissä määritellyt kohteet.
    • Esimerkiksi kyselyn, poll kohdalla voi auttaa että lisäät sen valikkoon (esim. navigaatio valikkoon), jolloin se myös ilmestyy Lisää sisältöä -luetteloon.
  • Views moduuli toimii mutta muokkaaminen on mahdotonta koska sivusto tulostaa seuraavanlaista koodia sivun täyteen: [{"command":"settings","settings":{"basePath":"\/drupal\/","pathPrefix":"fi\/","ajaxPageState":{"theme":"seven","theme_token":"sY4dWByw.........
    • Asetukset > Kehitys > jQueryn päivitys > valitse jQueryn versio 1.7. Näyttää olevan että 1.8 version Views ei toimi.
    • Jos tämä ei auta, tarkista että drupalin juuren .htaccess tiedostossa on risuaita RewriteBase rivin edessä: # RewriteBase / Tee tämän jälkeen välimuistin tyhjennys Suorituskyky kohdassa.
    • Googlessa hakusanana drupal views ajax not working

Vinkkejä[muokkaa]

Kirjautuminen huoltotilassa[muokkaa]

Kun sivusto on asetettu huoltotilaan sivustoon sisäänrakennetun ominaisuuden avulla ja sivusto heittää ylläpitäjän jossain vaiheessa ulos, niin kirjautuminen onnistuu www.sivustonnimi.fi/?q=user

Cron[muokkaa]

  • Drupal 6 versiossa joutuu asettamaan palvelimella cronin, Drupal 7:ssä tämä onnistuu asetusten kautta. Ohjeet Drupal 6 löytyy sivulta Cron.

Apple Touch Icon[muokkaa]

Applen laitteet yrittävät hakea /Drupal -hakemistosta otsikon mainitsemaa kuvatiedostoa. Tätä tiedostoa käytetään kun iPhonen tai iPadin käyttäjä haluaa lisätä selaamansa sivun linkin koti valikkoon. Tiedosto on tällöin se kuva, joka kotivalikkoon ilmestyy. Eri Applen laitteille on erikokoiset kuvat. Kuva tallennetaan png-24 ja sen koot löytyvät internetistä.

Kirjasta poistaminen[muokkaa]

  • Kirjaan on mahdollista lisätä muitakin sisältötyyppejä kuin vain kirjan sivuja. Niiden poistaminen kirjasta tapahtuu Hierarkia-välilehdeltä. Jos välilehden alareunassa ei näy poistopainiketta, valitse hierarkia-sivun yläosasta linkki jossa mainitaan uudelleenjärjestelystä. ja sieltä kirjan asetukset. Ota käyttöön sisältöyyppi, jonka haluat poistaa. Tämän jälkeen painike ilmestyy hierarkia-sivulle.

Kirjan tulostaminen pdf:nä[muokkaa]

  • Vaihtoehto 1
  1. Luo näkymä (Views), joka hakee kirjan sivut
    1. Muokkaamaton lista, Näytä Sisältö, Kirjan sivu, Lajittelukriteeri kirja hierarkia
    2. jos haluat vain tietyt sivut kannattaa ne merkitä esimerkisi tagilla (kts. kohta Massatoiminnot) ja sitten suodattaa ne sisällöstä.
  2. tee valikkolinkki: print/viewnäkymännimi
  3. tai avaa sivu /print/viewnäkymänimi

Massatoiminnot[muokkaa]

Views Bulk Operations (VBO) ja Administration Views -moduuleilla. Asennuksen jälkeen Näkymät-sivulle ilmestyy uusia näkymiä, joita voi muokata ja kun näkymän avaa sivuna, sillä pääsee tekemään muutoksia sivuihin. Esimerkiksi useiden sivujen taggaaminen kertaheitolla onnistuu valitsemalla Administration: Nodes -näkymän eli eli /admin/content > valitsemalla halutut sivut > toimenpide Muuta Arvo > tagin nimi ja lisää uusi tagi olemassaolevien joukkoon. Tagit Kannattaa lisätä näkymään tagi-kenttä, jolloin näkee mitä tageja sivuihin kuuluu.

Nopeuttaminen[muokkaa]

Sivusto saattaa olla hidas ja syitä voi olla monia. Sivustoa voi hidastaa esimerkiksi tietokannasta tehdyt haut, CSS ja Javaskriptien lataaminen, liian suuret kuvat, turhat moduulit.

  • TArkista Asetukset > Kehitys > Suorituskyky ja valitse sieltä kaikki mahdolliset
  • Kytke turhat moduulit pois käytöstä.
    • Onko käytössä Twitter moduuli? Ehkä se hidastaa sivun latautumista ainakin ensimmäisellä kerralla.

Pääsy kielletty[muokkaa]

Jos et pääse johonkin sivulle, kokeile ensin kirjautua sillä ylläpitäjän tunnuksella sisään jolla perustit alunperin Drupalin, usein se on käyttäjä 1 ja jos ei auta, kokeile seuraavaksi toisella selaimella, esim. Firefox toimii usein kun Safari ei toimi.

Tietokannan välimuistin (cache) tyhjennys[muokkaa]

Normaalisti ylläpidon sivuilta painikkeesta Asetukset > Kehitys > Suorituskyky > Puhdista kaikki välimuistit

Tietokannassa[muokkaa]

Valitse phpMyAdmin ohjelmassa tietokanta ja välilehti SQL. Lisää seuraava lista, johon muutat dr_ tilalle sen etuliitteen jota mahdollisesti käytät tietokannassa cache tauluissa. Muutat listan vastaamaan omaa cache-luetteloasi.

truncate table dr_cache ;
truncate table dr_cache_admin_menu ;
truncate table dr_cache_block ;
truncate table dr_cache_bootstrap ;
truncate table dr_cache_field ;
truncate table dr_cache_filter ;
truncate table dr_cache_form ;
truncate table dr_cache_image ;
truncate table dr_cache_l10n_update ;
truncate table dr_cache_libraries ;
truncate table dr_cache_media_xml ;
truncate table dr_cache_menu ;
truncate table dr_cache_page ;
truncate table dr_cache_path ;
truncate table dr_cache_update ;
truncate table dr_cache_variable ;
truncate table dr_cache_views ;
truncate table dr_cache_views_data ;

CSS-tiedostot[muokkaa]

  • Css-tiedostot ovat tiedostoja, jotka tietysti sivustolla vieraileva selain hakee palvelimelta jolla sivusto sijaitsee. Drupal suosittelee että css-tiedostoihin ei tule päästä käsiksi ulkopuolelta vaan niitä voi ainoastaan lukea drupal. Jos niitä ei voi hakea, tulostuu sivusto tietysti hassusti. Jatkuva yksittäisten tiedostojen hakeminen myös hidastaa vierailua sivustossa, joten Drupalissa on asetus, joka pakkaa poistaen turhat kommentit ja välilyönnit lukuisia moduulien css-tiedostoja yhdeksi suureksi tiedostoksi, jonka se tallentaa vapaasti haettavaksi avoimeen /files/css -kansioon. Myös java -ohjelmat voi antaa pakata samalla tavoin.
  • Drupal päivittää tämän css-tiedoston jos moduuli otetaan käyttään, kytketään pois tai moduuli päivitetään tai valitaan uusi teema sivustoon.
  • Drupal ei päiviätä tätä css-tiedostoa jos moduulin css-tiedostoa muutetaan tai teeman css-tiedostoa muutetaan. Tämä on tärkeää ymmärtää, koska helposti ihmettelee miksi suoraan css-tiedostoon tehty muutos ei tule näkyviin.
  • Jos Asetukset/Suorituskyky/Tiivistä ja pakkaa CSS tiedostot on kytketty päälle, muutokset CSS-tiedostoihin eivät siis tule näkyviin, koska web-selain hakee files/css -hakemistosta sinne luodun tiedoston joka ei muutu automaattisesti kun css -tiedostoon tehdään muutos. Täytyy siis kytkeä kyseinen CSS -valinta pois ja kytkeä se uudestaan päälle, jolloin drupal muodostaa uudestaan css-tiedostoja.
  • Saattaa kuitenkin käydä niin että kun CSS file aggregation kytketään pois ja jos sivustoa silloin käytetään, niin ilmestyy ruudulle virheilmoitus, sivusto on kaatunut. Ei siis välttämättä kannata poistus Suorituskyky sivulta kun raksit on poistettu vaan käydä esimerkiksi tyhjentämässä files/css -hakemisto manuaalisesti ja kytkeä raksit takaisin päälle ja vasta sitten poistua tältä asetussivulta. Muutaman sivun uudelleenlatauksen jälkeen kuitenkin sivusto aukeaa ja pystyy käyttämään sivua, vaikka sen ulkoasu on mitä sattuu. Tiedostojärjestelmään asetetut estot lukea css tiedostoja maailmalta suoraan moduuleista kun estää todennäköisesti niiden noutamisen. Kun css-asetus kytketään takaisin päälle, hetken kuluttua sivusto toimii taas normaalisti.
    • Ps. Jos ei toimi, tarkista että files-hakemiston .htaccess tiedosto-oikeus on vähintään 444.
  • Lisätietoa esimerkiksi Speed up a Drupal web site by enabling CSS file aggregation

Foorumi[muokkaa]

Foorumissa ei ole "Vastaa aiheeseen" -vaihtoehtoa, vaan vastaaminen tapahtuu kommentti-toiminnon avulla.

Galleria[muokkaa]

Oheisella ohjeella ja Views -moduulilla saa tehtyä toimivan kuvagallerian ja siihen voi liittää myös colorbo -moduulin. http://www.ostraining.com/blog/drupal/photo-gallery-drupal-7/

colorbox -moduuli avaa klikatessa kuvan ruutuun pimentäen samalla taustan. Asennus saattaa olla hiukan epäselvä.. mutta toimii kyllä lopulta.

Sivua ei voi poistaa[muokkaa]

Poistaessasi käyttäjän, saattaa käydä niin että jää nodeja, joita ei tämän jälkeen enää voi normaalisti poistaa. Ne näkyvät luetteloissa, mutta niitä avatessa tulostaa "File not foun" -virheilmoitus. Aseta tietokannan node -taulussa uid-sarakkeeseen käyttäjän numero, jolle annat oikeuden kyseiseen nodeen. Esimerkiksi 1 antaa ylläpitäjälle. Tämän jälkeen node on taas normaalisti luettavissa ja voit poistaa sen.

Työpöytä[muokkaa]

Työpöydän tiedot mitää "lohkokohtaisesti" Määritellä. Lohkon oikeassa yläkulmassa on ratas, jossa on kohta Määrittele. Aseta siellä tarvittavat asetukset saadaksesi lohkon näyttämään tietoa. Jos olet määritellyt lohkon näkymään vain listatuilla sivuilla, käytä silloin admin/dashboard saadaksesi sen näkymään työpöydällä.

Ohjelmointi[muokkaa]

Katso oma sivu Drupal ohjelmointi

Hakemiston vaihtaminen[muokkaa]

EI TESTATTU KUN EI TARVINNUTKAAN

Ilmoitukset julkaisuista[muokkaa]

Sivustolla kirjoitetun sisällön julkaisemisesta voi laittaa automaattisen sähköpostiviestin tulemaan esimerkiksi ylläpitäjälle.

  • Asetukset / Järjestelmä / Toimenpiteet / Luo laajennettu toiminto: Lähetä sähköpostia... Luo / Yksilöi tunnus, aseta vastaanottja, aihe ja viestikenttään oheinen teksti.
  • Asetukset / Järjestelmä / Toimenpiteet / Tilanteet (yläosassa sivua) / Valitse ylhäältä kommentti tai sivu sen mukaan mitä ilmoitetaan / Liipasin: Tallentaessasi.. Valitse toimenpide: Lähetä sähköpostia uudesta... Liitä tilanteeseen.
Aihe [comment:node:title] osoitteessa: [site:url]/node/[comment:node:nid]#comment-[comment:cid]

Kirjoittanut [comment:author:name]
Aihe [comment:title]

[comment:body]
# Jostain syystä linkki ei toimi tässä
Aihe [node:title] osoitteessa: [site:url]/node/[node:nid]

Kirjoittanut [node:author:name]
Aihe [node:title]

[node:body]

IMCE[muokkaa]

  • Moduulin avulla määritetään eri profiileja, jotka määritellää käyttäjärooleille. Profiileilla voi olla erilaiset asetukset kuvatiedostojen lataamiseen. Aseutksissa määritellään esimerkiksi kuinka paljon yhteensä voi ladata kuvamateriaali käyttäjäkohtaisesti. IMCE määrittelee myös mitkä sites/default/files -hakemistot näkyvät.
  • Jos kuvaa ladatessa ilmenee virheilmoitus: Tiedostoa x.jpg siirtäminen palvelimelle epäonistui. X.jpg koko on x KB, mikä ylittäisi käyttäjäkohtaisen levytilarajoituksen. Käytät tällä hetkellä x MB levytilarajoituksesta x MB. Saattaa olla että Asetukset valikosta ei löydy sopivaa latausten kokonaismäärän asetuskohtaa, koska asennettuasi IMCE-moduulin se sen moduulin profiilin takana. IMCE löytyy Asetukset/Media/IMCE.

Kieli[muokkaa]

Ilmestyykö jokaisen sivun perässä maininta "Kieli suomi". Se kytketään päälle tai pois jokaisen sisältötyypin kohdalla erikseen. Valitse Rakenne/Sisältötyypit ja halutun sisältötyypin kohdalta Ylläpidä näkymää ja valitse Kieli -kohdan muodoksi Piilotettu. Ja jos ei kuitenkaan häviä, esimerkiksi saattaa jäädä "staattiselle" syöttötyypille, niin lisää käyttämäsi teeman (/drupal/sites/all/themes/teemannimi/templates/node.tpl.php -tiedostoon riviksi 102 seuraava: hide($content['language']);

Luettu x kertaa[muokkaa]

Linkin saa poistettua kohdasta Käyttäjät/Käyttöoikeudet/Statistics.

Massalataus[muokkaa]

  • Useamman kuvan lataukseen on useampia moduuleita (joista osa saattaa olla aika hankala saada toimimaan). Eräs yksinkertainen on moduuli Plup (Plupload widget). Siinä latausruutuun voi hiirellä vetää kuvia tiedostohakemistosta tai tehdä sen valitsemalla.
    • Plup vaatii plupload asennuksen. Ohjelmalla on omat kotisivut, josta sen voi ladata. Ohjelma asennetaan /drupal/sites/all/libraries/plupload -hakemistoon. POISTA examples -hakemisto asennuksesta tietoturvan takia!
    • Eräissä ohjeissa pyydetään myös tyhjentämään välimuisti joka löytyy /Asetukset/Kehitys/Suorityskyky -kohdasta.
    • Plup moduuli kytketään päälle asettamalla sisältötyyppiin kuvakentän ja sille vimpaimen Plupload. Muista käydä asettamassa Käyttäjät/käyttöoikeuksissa oikeudet Plupload widget -kohtaan ketkä saavat ladata kuvia.
    • Jos kuvat eivät tule näkyviin kun ne on latautuneet. Lisää seuraava rivi /drupal/sites/default/settings.php -tiedostoon. Sinun täytyy todennäköisesti muuttaa Write -asentoon (644) tiedoston oikeus täksi ajaksi. Muuta sen jälkeen se takaisin 444 -oikeuteen.
  • Plup integration module ja Field Collection Bulk upload
    • Jos ruudun yläreunaan ilmestyy virheilmoitus punaisessa palkissa: Notice : Undefined index: fi in field_collection_bulkupload_add_form() (line 47 in /sites/all/modules/contrib/field_collection_bulkupload/field_collection_bulkupload.module). Katso sivulta https://drupal.org/node/2033115 ohje eli lisää seuraava rivi koodiin. Eli riville 35 + -merkillä merkitty rivi ilman + -merkkiä:
 function field_collection_bulkupload_field_attach_form($entity_type, $entity, &$form, &$form_state, $langcode) {
   $fields = field_info_instances($entity_type, $form['#bundle']);
   foreach($fields as $name => $field) {
     if ($field['widget']['type'] == 'field_collection_embed') {
       $build_id = $form_state['build_info']['form_id'];
+       $langcode = field_language($entity_type, $entity, $name, $langcode);
       field_collection_bulkupload_add_form($form[$name], $name, $langcode, $build_id);
     }
   }
 }


Tietokannan päivitys ei onnistu[muokkaa]

Ongelma ilmenee usein siinä että päivitysskripti tulostaa mitä pitäisi tehdä mutta kun painetaan Continue, avautuu uusi sivu, jossa on sama valikko vasemmalla, mutta muutoin valkoinen sivu. Tämä ongelma saattaa johtua useasta seikasta. Ohessa on vaihtoehtoja sen ratkaisuun. Mutta usein kysymys on jostain moduulikansioon liittyvästä.

Ratkaisu 1[muokkaa]

  • Drupal update not work --> try Firefox instead of Safari.

Ratkaisu 2[muokkaa]

Tämä vaihtoehto todennäköisesti toimii, mutta se nollaa kaikki ytimen ulkopuoliset moduulit pois päältä eli hakemistossa /sites/all/modules olevat. Tämän jälkeen ne on kytkettävä manuaalisesti taas päälle.

  • Ota kopio moduulisivusta tai jollain tavoin luetteloin, mitkä olet kytkenyt päälle. Näin ne on helpompi palauttaa samoihin asetuksiin varsinkin jos moduuleita on paljon ja vain tiettyjä kohtia moduulin toiminnoista on raksittu päälle.
  • Siirry Moduulit > tietokannan päivitysscripti Näkyviin jää päivitysskriptin aloitussivu.
  • /sites/all/ -hakemistossa nimeä hakemisto modules toiselle nimelle esm. amodules
  • Palaa taksisin päivityssivulle ja paina nyt Continue
  • Sivusto raksuttaa hetken ja ilmoittaa ettei mitään päivitettävää ole.
  • Muuta takaisin hakemisto nimeksi modules
  • Aja päivitysskripti uudestaan ja sen pitäisi nyt toimia.
  • Kytke moduulit takaisin päälle.
  • Jos hukkaat asetukset sivun muokkaa osoiteriviä. domain.fi/drupal/index.php/#overlay=fi/admin/config

Muita ehdotuksia[muokkaa]

  • www.domain.fi/drupal/update.php tai drupalin sisältä tietokannan päivityksen ajaminen ei onnistu vaan Run updates -kohdassa ruutu jää tyhjäksi ja mitään ei tapahdu.
  • Aivan ensimmäiseksi kokeile toisella selaimella esimerkiksi Firefox, Chrome, Explorer tms. Esimerkiksi Safari ei välttämättä aja päivitystä, mutta Firefox ajaa samassa tietokoneessa välittömästi. Kaikki menee review vaiheeseen asti hyvin.
  • Jos edelliset eivät auta löydät tietoa mahdollisesti oheisista linkeistä, mutta tarkista ainakin yleisimmät ongelmat ensin:
    • Kirjaudu sinä käyttäjänä Drupaliin, jonka Drupalin asennusvaiheessa perustit ensimmäisenä, käyttänumero on yleensä 1
    • Jos et voi kirjautua edellisellä, muuta sites/default/settings.php tiedostoon $update_free_access = TRUE; mutta muista palauttaa takaisin! Nyt voit suorittaa päivityksen suoraan osoiteriviltä vaikka et ole kirjautuneena sisään.
    • Muuta käyttämäsi teema sites/default/settings.php tiedostossa alkuperäiseksi poistamalla risuaita riviltä $conf['theme_default'] = 'garland'; Tämä voi esimerkiksi pääsää sinut kirjautumaan sivustoon.
    • Varmista että sites/default/settings.php tiedostossa $base_url on asetettu oikein
    • Varmista että hakemistojen pääsyoikeudet ovat oikein esim. moduulikansioissa ym. oleellisissa.
    • Ehkä moduulien kytkeminen tietokannasta pois taulusta system asettamalla status arvoksi 0

Valkoinen sivu[muokkaa]

White Screen of Death eli WSOD.

https://drupal.org/node/158043

Yhteenvedon pituus[muokkaa]

Voit node-kohtaisesti määritellä pääsisällön sisällä oheisella komennolla, mistä kohdasta yhteenveto (lyhennelmä) poikkastaan. Esimerkiksi jos haluat pitemmän kuin asetuksissa on määritetty. Tämä voisi tulla kyseeseen esimerkiksi frontpage -sivulle. Kirjoita teksti normaalisti, paina Täysi HTML pois päältä asetukseen paljas teksti ja lisää oheinen rivi katkaisukohtaan ja paina Täysi HTML takaisin päälle ja tallenna. Muista että tällöin yhteenveto-kohdan pitää olla tyhjä.

<!--break-->

Turvallisuus[muokkaa]

Lue tämä kohta myös ennen uusien teemojen ja moduulien asentamista!

Turvallisuuspäivitykset[muokkaa]

Drupalin ytimestä (Drupal core) ja moduuleista paljastuu aika ajoin tietoturva-aukkoja, joten niitä joudutaan jatkuvasti päivittämään. Lisäksi samalla yleensä parannetaan ohjelman toimivuutta. Ytimellä tarkoitetaan varsinaista Drupal-sovellusta, joka pyörittää sivustoa ja jonka aliohjelmia moduulit ovat.

Drupal suosittelee päivittämään niin pian kuin mahdollista turvallisuuspäivitykset. Joskus päivitykset pitää tehdä "välittömästi" tai sulkea sivusto varmuuden vuoksi kunnes kerkeää tekemään päivitykset. Joskus riittää pelkän patch:n avulla korjaaminen, jos koko päivitystä ei kerkeä tehdä. Saatavilla olevat päivitykset > Asetukset kohdasta kannattaa laittaa turvallisuuspäivitysilmoitus tulemaan sähköpostiin. Sähköpostiin tulee tällöin ilmoituksia myös moduuleista, joita sivustollasi ei välttämättä ole käytössä. Päivityksistä näkee kuinka tärkeä päivitys on kyseessä ja erityisesti todellisiin uhkiin on syytä reagoida välittömästi. Tärkeys on ilmoitettu 25-portaisella asteikolla ja tekstillä. Joskus haavoittuvuus voi olla niin paha, että sinulla ei ole kuin muutama tunti aikaa toimia! Käytännön kokemuksesta voidaan sanoa, että on paljon suurempi työ usein puhdistaa sivusto, joka on hakkeroitu.

Moduulit pystyy yleensä päivittämään Raportit > Saatavilla olevat päivitykset > Päivitä, mutta ydin joudutaan päivittämään manuaalisesti ainakin 7.z versiossa. "Upgrade" tarkoittaa esim. 6.1 versiosta 7.1 versioon ja "Update" tarkoittaa esim. 7.1 versiosta 7.2 versioon. Ymmärrettävää, että update eli päivitys on pienempi toimenpide. Upgrade-muutokseen saattaa vierähtää useampikin päivä, kun update päivityksestä usein selviää tunnissa parissa. Yleisin "hidaste" päivityksessä on tiedosto-oikeuksien saaminen taas kohdalleen.

Ytimen päivitys[muokkaa]

Huom! Ytimen päivitys saattaa saada sivuston toimimattomaksi. 

Tärkeintä on ottaa ensin varmuuskopio sekä tiedostojärjestelmästä että tietokannasta. Saattaa käydä niin että ytimen päivitys tai moduulin asennus sotkee niin pahasti järjestelmän, että helpoin keino on palauttaa viimeisin varmuuskopio ja aloittaa päivitys alusta. Varmuuskopiosta voi tarvittaessa myös tarkistaa miten asiat olivat ennen päivitystä ja jopa palauttaa räätälöityjä tiedostoja, jotka vahingossa tuli päivityksen yhteydessä poistettua.

Huomaa myös että /sites -hakemisto sisältää lähtökohtaisesti kaikki omat muutoksesi, joten älä korvaa sitä uudella päivityksen mukana tulevalla /sites -hakemistolla! Jos olet tehnyt muutoksia muualle, ne tietysti myös menetetään päivityksen yhteydessä ja täytyy asettaa uudestaan. Tällaisia ovat esimerkiksi muutokset moduuleissa ja tiedosto-oikeudet. Myös juurihakemistossa saattaa olla tiedostoja, jotka ovat käyttäjän sinne itse asettamia.

Toimenpide etenee lähtökohtaisesti seuraavasti:

  1. varmuuskopioidaan tietokanta ja tiedostojärjestelmä
  2. poistetaan vanha tiedostojärjestelmä säilyttäen tietyt omat tiedostot
  3. asennetaan uusi tiedostojärjestelmä
  4. päivitetään tietokanta
  5. päivitetään moduulit ja uudestaan tietokanta.

Päivityksen voi suorittaa pääte-ohjelmalla (Terminal jne.), tiedostonhallintaohjelmalla (cPanel File Manager, Cyberduck jne.) tai kummallakin samanaikaisesti. Nopeinta on suorittaa pääte-ohjelmalla SSH-yhteyden avulla. SSH-ohje: SSH.


Tämä ohje on kirjoitettu päivitettäessä 7.60 --> 7.62 (21.1.2019). On siis hypätty yhden päivityksen yli. (Versionumero: Raportit > Tilanneraportti)

  1. Drupal lataussivu
    1. Raportit > Tilanneraportti > Klikkaa punataustaista kohtaa Turvaton! (versio x.xx on saatavilla) > Julkaisutiedot (Huom. varmista, että kyseessä on todellakin viimeisin versio!!! Saattaa olla, että linkki vie vanhaan versioon.)
    2. Lue Drupalin sivulta mahdolliset huomiot, jossa on kerrottu muutoksista, esimerkiksi onko tarvetta muuttaa .htaccess, web.config, robots.txt, default settings.php -tiedostoja. Näissähän on todennäköisesti omia sivustokohtaisia muutoksia, joten niiden ylikirjoittaminen nollaisi ne.
  2. Katso ettei kukaan ole linjoilla ja aseta sivusto huoltotilaan Asetukset > Kehitys > Huoltotila.
  3. Ota Moduulit -sivusta varmuuden vuoksi kopio (esm. pdf-tuloste), jolloin käytössä olevat moduulit on helppo raksia takaisin käyttöön päivityksen jälkeen sen mukaan jos ne jostain syystä ponnahtavat itsekseen pois päältä. Tämä on harvinaista, mutta mahdollista.
  4. ÄLÄ POISTU TAI KIRJAUDU ULOS SIVUSTOSTA, JÄTÄ SELAINIKKUNA AUKI, ÄLÄKÄ KÄYTÄ SIVUSTOA SEURAAVIEN VAIHEIDEN AIKANA.
  5. Varmuuskopioi tiedostojärjestelmä JA tietokanta.
    1. Tietokannan kopiointi phpMyAdmin:lla omalle tietokoneelle: cPanel > Databases > phpMyAdmin > valitse drupaltietokanta sivupalkista > Export > Quick > Go
    2. Tietokannan kopiointi Drupalin varmuuskopiointi-lisäosalla palvelimelle.
    3. Tiedostojärjestelmän kopiointi pääteohjelmalla (nopea): Yksi hakemisto ylempänä kuin itse drupal-hakemisto komento: zip -r drupalvvkkpp_versioxxx_ennen_ydinpaivitysta_toimiva.zip drupalhakemistonimi TAI pakkaamaton tiedostojärjestelmä: cp -R drupalhakemistonimi drupalvvkkpp_versioxxx_ennen_ydinpaivitysta_toimiva
    4. Tiedostojärjestelmän kopiointi cPanel:lla: Files > File Manager > Valitse drupal-hakemisto > Compress > Esim. Gziped Tar Archive
    5. Tietokannan kopiointi cPanel:lla palvelimelle: cPanel > Backups Manager > Backup Tool > Create Backup (Esim. Siteground-palvelussa vaatii vähintään GoGeek)
  6. Poista muut hakemistot alkuperäisestä Drupal tiedostohakemistosta lukuunottamatta /tmp ja /sites -hakemistoja sekä muita mahdollisia itse lisäämiäsi hakemistoja ja tiedostoja. Sites -hakemisto sisältää itse asentamasi moduulit, teemat ja tiedostot. Koska otit edellä tiedostojärjestelmästä varmuuskopion, voit myöhemmin palauttaa sieltä unohdettuasi jotain. Ei kannata tuhota varmuuskopiota esimerkiksi ennen seuraavaa päivitystä, koska tarvetta voi ilmetä myöhemmin palauttaa jotain mitä ei muistanutkaan tehneensä kun sitä toimintoa taas käyttää.
    1. drupal-hakemistossa hakemistot: rm -r includes | rm -r misc | rm -r modules | rm -r profiles | rm -r scripts | rm -r themes tai tiedostonhallintaohjelmalla. JÄTÄ seuraavat hakemistot: /sites ja /tmp.
  7. Poista drupal-hakemistossa tiedostot: rm tiedostonimi tai tiedostonhallintaohjelmalla (esm. cPanelin kautta). JÄTÄ seuraavat: .htaccess, favicon.ico, google-tunnistustiedosto.html, js.php, (robots.txt, web.config, chatblock.php).
  8. Tyhjennä tmp -hakemisto (oikeus 750) muutoin, mutta jätä .htaccess tiedosto.
  9. Lataa viimeisin Drupal-versio suoraan palvelimelle tai ensin omalle tietokoneelle ja siitä palvelimelle public_html -hakemistoon.
    1. Suoraan palvelimelle (nopea): Hiiren oikealla kopioi zip-tiedoston linkki > cd public_html > wget kopioitu linkki cmd-v:llä tähän
  10. Pura paketti (muodostuva hakemisto on nimeltään drupal-x.xx): unzip tiedostonimi tai tiedostonhallintaohjelmalla Extract suoraan public_html-hakemistoon.
  11. Poista paketista /sites -hakemisto ja muut tiedostot jotka jätit edellä vanhaan hakemistoon, ettet ylikirjoita olemassaolevia tiedostoja.
    1. cd hakemistonimi > rm -r sites | rm .htaccess ja tarvittaessa rm robots.txt | rm web.config
  12. Siirrä kaikki hakemistot ja tiedostot paitsi siis /sites ja muut, jotka jätit aikaisempaan drupal-hakemistoon, ja voisi nyt tulla ylikirjoitetuksi (jos et poistanut niitä aiemmin) purkamastasi uudesta Drupal-paketista Drupal-hakemistoosi.
    1. cPanel File Manager: Valitse tiedostot > Move File > kohdehakemisto
  13. Poista väliaikainen drupal-x.xx -hakemisto.
  14. Jos päivitys sisältää muutoksia settings.php -tiedostoon, korvaa vanha settings.php osoitteessa /sites/default/ uudella ja muuta tiedostoon omat sivustokohtaiset asetukset (esim. tietokannan nimi, käyttäjä ja salasana). Muutoksista on tarvittaessa ilmoitettu Drupal-version Notes-lataussivulla.
  15. Jos päivitys sisältää muutoksia .htaccess -tiedostoon tai muihin tiedostoihin tee tarvittavat muutokset aivan tämän ohjeen alussa kerrotun Notes -sivun antamien ohjeiden mukaan. Esimerkiksi jos private ja files -hakemistojen .htaccess tiedostot täytyy vaihtaa, poista vanhat ja mene Asetukset / Media / Tiedostojärjestelmä ja paina Tallenna asetukset. Drupal luo tällöin automaattisesti .htaccess tiedostot kyseisiin kansioihin.
  16. Siirry nyt kotisivulle, jota et aiemmin sulkenut ja siirry sivulle Raportit > Tilanneraportti niin monta kertaa että saat päivitykseen liittyvät punaiset muutokset korjattua. Sivustossa saattaa olla ulkoasuongelmia, koska tiedosto-oikeudet eivät välttämättä ole kohdallaan tms.
    1. Suorita ensimmäisenä tietokannan päivitys: Moduulit > sivun yläosassa linkki 'tietokannan päivitysscripti'.
      1. "The following module is missing from the file system..." -virhelmoitus päivitysscripti-sivulla ja lokitiedostossa: https://www.drupal.org/node/2487215 1) Kokeile ensin tyhjentää välimuisti. 2) Tätä vaihtoehtoa ei suositella, mutta näyttäisi toimivan: phpMyAdmin ohjelmassa tietokannassa anna SQL-komento kyseiselle moduulille, jonka nimi näkyy virheilmoituksessa: DELETE FROM mahdollinentietokannanetuliite_system WHERE name = 'moduulinnimi' AND TYPE = 'module' ja tyhjennä välimuisti Asetukset > Kehitys > Suorituskyky > Puhdista kaikki välimuistit.
  17. Päivitä moduulit. Moduulit > Päivitä. Katso tarkemmat ohjeet kohdasta Moduulien päivittäminen. Tämä on nyt hyvä tehdä, koska myöhemmin kannattaa tiukentaa tiedostojärjestelmän oikeuksia ja päivitys voi tämän takia olla hankalampaa, riippuen tietysti miten tiukaksi oikeudet säädät.
      1. Päivitä aina tietokanta moduulipäivityksen jälkeen. Tee jokainen moduuli päivitys yksi kerrallaan ja sen perään heti tietokannan päivitys. Moduulit > sivun yläosassa linkki tietokannan päivitysscripti. Tällöin näet heti jos sivusto kaatuu, mikä moduuli on syynä.
    1. Suorita uudestaan Raportit > Tilanneraportti ja siellä olevat tehtävät pois.
  18. Tyhjennä kaikki välimuistit Asetukset > Kehitys > Suorituskyky > Puhdista kaikki välimuistit
  19. Ota varmuuskopio tietokannasta ja tiedostojärjestelmästä.
    1. Pakattu tiedostojärjestelmä pääteohjelmalla: Yksi hakemisto ylempänä kuin itse drupal-hakemisto: zip -r drupalvvkkpp_versioxxx_jalkeen_ydinpaivityksen_toimiva.zip drupal
  20. Aseta tiedostoille oikeudet, katso kohta 'Hakemistojen oikeudet'.
  21. Aseta sivusto huoltotilasta pois. Asetukset > Kehitys > Huoltotila
  22. Tyhjennä kaikki välimuistit Asetukset > Kehitys > Suorituskyky > Puhdista kaikki välimuistit
  23. Testaa sivustoa toisella selaimella. Sekä kirjautumattomana että kirjautuneena. Muista että joskus selaimen välimuistit temppuilevat, ja sivusto ei lataudu oikein vaikka teet muutoksia.
  24. Tee tarvittavat korjaukset. Esm. /misc/favicon.ico on muuttunut Drupalin omaksi, joten kopioi sinne oma ikoni jos tarve vaatii.

Hakemistojen oikeudet[muokkaa]

Vaikka Drupalia voidaan pyörittää löysemmilläkin turvallisuusasetuksilla, on syytä perehtyä Drupalin sivuun Securing file permissions and ownership ja tehdä tarvittavat "tiukat" asetukset. Turvallisuudesta on lisäksi Drupalin sivulla Securing your site. Ohessa on ohjeita, mutta ei välttämättä ajantasaisia.

  • Asenna moduuli Security Review. Tämä tarkistaa sivuston turvallisuutta.
  • Huolehdi että etenkin ylläpitäjien salasanat ovat vahvoja ja vaihdetaan ajoittain.
    • Katso tästä mitä "oikeudet" tarkoittavat.

Apache prosessi[muokkaa]

"Apache prosesseille kaikki tiedostot vain luku-oikeuksilla ja omistajana joku muu käyttäjä". Usein Apache eli palvelimella Drupalia ajava ohjelmisto toimii käyttäjänä (user) www-data, ryhmässä (group) www-data.

  • Tämän käyttäjän tulee pystyä lukemaan kaikkia drupal-hakemiston tiedostoja sekä User, Group, World (Other) -oikeuksilla. Lukuoikeudeksi kansiolle riittää 750 ja tiedostolle 640 sekä laajennettuna eräillä kansioille 755 ja tiedostoille 644.
  • Apache-käyttäjällä ei tule siis olla pääsääntöisesti poikkeuksia lukuunottamatta kirjoitusoikeuksia Drupal-hakemistoon.
    • /drupal -kansiossa palvelimella (eli "drupalilla") tulee olla kirjoitusoikeus ainoastaan files-kansioon ja moduulien kuvakansioihin. Sen ei tule pystyä kirjoittamaan mitään kansioihin, jota se pystyisi ajamaan ja näin vahingoittamaan sivustoa.

Oikeuksien asetus Linux -palvelimella[muokkaa]

Huom! Muutosten jälkeen sivut eivät välttämättä toimi! Alempana on esitetty ratkaisuvaihtoehtoja, lue ne ensin.
Huom! Uudet moduulit, teemat tai muut lisäosat, jotka asennetaan myöhemmin täytyy myös muuttaa kyseisiin oikeuksiin. 
OTA VARMUUSKOPIO TIETOKANNASTA JA /DRUPAL -HAKEMISTOSTA (ohje kohdassa Ytimen päivitys)

  • Varmistu aluksi, että
  1. palvelin on Linux
  2. käyttäjä kuuluu ryhmään
  3. ?? drupal on palvelimella joka ei ole hosting-ympäristö joka tarjoaa sivusto hostingia useille asiakkaille ??
  • Komennot annetaan pääteohjelman kautta yksitellen ja palvelimelle kytkeydytään SSH-yhteydellä.
  • Ajat komennot drupal-hakemiston sisällä sen juuressa että vaikutus on kaikkiin sen alihakemistoihin (files-hakemisto ajetaan toisaalla)
  • Huomaa, että erityisesti tiedostoihin vaikuttavat muutokset voivat kestää tiedostojesi määrästä riippuen, joten odota komennon valmistumista.
  • Jätä pois chown-oikeudet jos ne ovat jo oikein tai sinulla ei ole käyttöoikeuksia chown-komennon käyttämiseen.
  • Kopioi komennot kopioi - sijoita suoraan tältä sivulta tai mielellään Drupalin sivulta. Älä kopioi Wikikon "muokkaa"-sivulta, koska ne eivät välttämättä silloin toimi.

Tiedosto-oikeuskoodeja[muokkaa]

drwxr-xr-x = 755 => u=rwx,go=rx
-rw-r--r-- = 644 => u=rw,go=rr
drwxr-x--- 750 => u=rwx,g=rx,o=
-rw-r----- 640 => u=rw,g=r,o=
-rw-rw-r-- = 664 => u=rw,g=rw,o=r

Drupalin kotisivuilla neuvotaan[muokkaa]

  • Tällä sivulla olevat ohjeet poikkeavat näistä ohjeista.
https://www.drupal.org/node/244924
/modules/themes hakemistot: rwxr-x--- 750
/modules/themes tiedostot: rw-r----- 640
/files hakemisto ja sen alahakemistot: rwxrwx--- 770
/files hakemiston ja alahakemistojen tiedostot: rw-rw---- 660

Drupal-oikeudet esimerkki 1[muokkaa]

Ohje etenee niin, että ne kirjoitetaan rivi kerrallaan järjestyksessä kaikki, koska niissä on hakemistosta toiseen siirtymisiä ja ohjauksia.

1. Asetetaan yleisoikeudet[muokkaa]

  • Seuraavat komennot asettavat sopivat oikeudet aluksi koko drupal-jäjrestelmään. Tämän jälkeen kaikki toiminnot eivät toimi vaan vaativat erityisiä hakemisto- ja tiedostokohtaisia oikeuksia.
  • rivi 1 siirrytään /drupal -hakemistoon
  • rivi 2 VAIN TARVITTAESSA. Asettaa omistajaksi aapeli, ryhmäksi www-data. Huomaa välilyönti ja piste lopussa
  • rivi 3 etsii kaikki hakemistot ja alihakemistot ja asettaa aapelille (omistaja) luku-kirjoitus-pääsy -oikeudet, ryhmälle (www-data) luku-pääsy ja muille ei mitään eli 750
  • rivi 4 etsii kaikki tiedostot ja asettaa aapelille luku-kirjoitus -oikeudet, ryhmälle vain lukuoikeudet ja muille ei mitään eli 640
cd drupal
chown -R aapeli:www-data .
find . -type d -exec chmod u=rwx,g=rx,o= '{}' \;
find . -type f -exec chmod u=rw,g=r,o= '{}' \;

2. Asetetaan erityisoikeudet[muokkaa]

  • drupal-hakemiston oikeus 755 eli
cd ..
chmod u=rwx,go=rx drupal
  • drupal/.htaccess -tiedosto 644 (jos alhaisempi, ei toimi ja ilmestyy 403-virheilmoitus)
cd drupal
chmod 644 .htaccess
  • /misc hakemistolle 755 ja kaikille tiedostoille 644
cd misc
find . -type d -exec chmod u=rwx,g=rx,o=rx '{}' \;
find . -type f -exec chmod u=rw,g=r,o=r '{}' \;
  • /themes hakemistolle ja sen alahekemistoille 755 ja kaikille tiedostoille 644
cd ../themes
find . -type d -exec chmod u=rwx,g=rx,o=rx '{}' \;
find . -type f -exec chmod u=rw,g=r,o=r '{}' \;
  • /sites hakemistolle 755
cd ..
chmod u=rwx,go=rx sites
  • /sites/all ja sen kaikille alahakemistolle 755 ja kaikille tiedostoille 644
cd sites/all
find . -type d -exec chmod u=rwx,g=rx,o=rx '{}' \;
find . -type f -exec chmod u=rw,g=r,o=r '{}' \;
  • /sites/default/settings.php tiedosto 440 TÄMÄ ON TÄRKEÄ!!
cd ..
chmod a-wx default/settings.php
  • /sites/default hakemistolle 555 (755 jos ei toimi)
chmod 555 default
  • /sites/default/files hakemistolle seuraavat:
    • siirry /drupal/sites -hakemistoon, jos et jo ole siellä.
    • kopioi nyt kerralla seuraava find-komennosta done-komentoon asti ja liitä se komentoriville ja paina enter.
    • rivi 1 etsii /sites/default/files-hakemiston ja asettaa sille 755
    • rivit 2,3,6 tekevät silmukan. Kopioi vain silmukka päätteeseen eli rivit 2-6 ja paina enter
      • silmukka toimii sh-tyylisessä shell:issä eli sh, bash, ksh. Jos käytät csh tai tcsh, kirjoita bash ennen silmukan ajamista.
    • rivi 4 asettaa kaikkiin files-hakemiston alihakemistoille 755 -oikeudet
    • rivi 5 asettaa kaikkiin files-hakemiston ja sen alihakemistojen tiedostoille 664 -oikeudet
find . -type d -name files -exec chmod u=rwx,go=rx '{}' \;
for d in ./*/files
do
    find $d -type d -exec chmod u=rwx,go=rx '{}' \;
    find $d -type f -exec chmod ug=rw,o=r '{}' \;
done
  • /sites/default/files/.htaccess hakemisto 444 (tai 440), niin ei anna virheilmoitusta turvallisuustarkastusta tehtäessä.
 chmod 444 default/files/.htaccess
  • /modules/file/icons tiedostoille 644 ja /modules, /file, /icons -kansioille 755, jotta tiedostokuvakkeet näkyvät.
cd ..
chmod 644 modules/file/icons/*
chmod 755 modules
chmod 755 modules/file
chmod 755 modules/file/icons
  • Saattaa olla että /drupal/robots.txt pitää muuttaa 640 asetukseen että hakukoneet sen löytävät
chmod 640 robots.txt

php[muokkaa]

Selvitettävä: https://drupal.org/node/615888

Vinkkejä kun sivut eivät toimi oikein em. oikeusasetusten jälkeen[muokkaa]

  • Sivustolle ei pääse, ilmoittaa Permission denied, 403 - Forbidden Error tms.
  1. Tarkista että drupal-hakemistossa .htaccess -tiedosto on oikeudella 444 (tai jos ei toimi 544 tai 644)
  2. Tarkista että drupal-hakemiston oikeus on 755 eli
cd ..
chmod u=rwx,go=rx drupal
  • Ylläpidon moduulit-sivu tulostuu oudosti. Ongelma saattaa olla käyttämässäsi teemassa, vaihda YLLÄPIDON teemaksi esim. Garland.
  • Vaihtuva teeman banneri ei ilmesty. Kyse on todennäköisesti tiedosto-oikeuksista. Esimerkiksi sites/ ja sites/default pitää olla 755.
  • Suoraan käännös ei toimi. Kyse on todennäköisesti tiedosto-oikeuksista. Esimerkiksi sites/ ja sites/default pitää olla 755.
  • Wysiwyg-editori ei toimi. Kyse on todennäköisesti tiedosto-oikeuksista. Esimerkiksi sites/ ja sites/default pitää olla 755.
  • Teema ei tulostu, vaan ainoastaan sivut tulostuvat linkkeinä, kuvakkeita (ikoneja) ei näy jne. jne.
    • Tarkista aivan ensimmäiseksi että /sites/default/files-hakemiston .htaccess tiedosto-oikeus on vähintään 444. Ei meinaan auta vaikka mitä olisi hakemisto- ja tiedosto-oikeudet jos muut eivät pääse lukemaan tätä tiedostoa!
    • Todennäköisesti sites/ ja sites/default ja sites/default/files ja files-hakemistossa oleva kansiot vaativat 755 (tai 775) -oikeudet ja tiedostot 664 -oikeudet (tai 644) toimiakseen. Etenkin /cache /css /ctools, /js ja /languages kansioita palvelin käyttää aktiivisesti. Lisäksi omat kuvatiedostot ja kansiot vaativat pääsyoikeudet.
    • On tärkeää ymmärtää että kyseisen tiedoston oikeus ei riitä, vaan kansiolle jossa tiedosto sijaitsee pitää antaa tarvittavat oikeudet ja tarvittaessa avata polku /drupal -hakemistosta lähtien eli jokainen kansio joka johtaa kyseiseen tiedostoon pitää asettaa vähintää 755 oikeuteen. /files-kansiossa todennäköisesti vielä 775.
    • KUVAKKEET. Pienet kuvakkeet, esm. pdf-kuvake vaativat koko polun /modules/file/icons/ kaikkien kansioiden asettamista 755 ja tiedostot 644
    • Moduuli (/drupal/modules ja /sites/all/modules), libraries ja käyttämäsi teeman kuvat pitää myös muuttaa 755 ja 644 -oikeuksiin. Usein ne sitaitsevat images -tyyppisissä kansioissa. Voidaan siis sanoa että kaikki kuvaketiedostot pitäisi saada 644 ja hakemistot avattua niihin juuresta. /misc ja kummassakin /modules hakemistossa on useita hakemistoja jotka täytyy muuttaa.
    • Tyhjentele välillä välimuistia (löytyy kohdasta asetukset/kehitys/suorituskyky ja kirjaudu myös ulos ja uudestaan sisään ylläpitäjänä.
    • Apuna kannattaa käyttää Raportit/Viimeisimmät lokimerkinnät, josta virheinä palkkeina näkyy kuvatiedostot joita ei löydy
    • Jos etsit missä tietty kuva sijaitsee, katso selaimen lähdekoodia. Helpottaa jos on käytössä joku lisä osa tai esim. Safarissa löytyy suoraan kuvat ja polku mistä kuvaa haetaan (Näytä lähdekoodi/vasemmalta Kuva-hakemisto ja oikealla näkyy Sijainti.
    • Oheisia komentoja kannattaa käyttää kyseisten hakemiston juurissa, jos haluaa päästä helpommalla. Se asettaa kaikki kyseisen hakemiston ja sen alahakemiston kansiot ja tiedostot 755 ja 644 arvoihin:
find . -type d -exec chmod u=rwx,g=rx,o=rx {} \;       asettaa hakemistoille oikeudet 755
find . -type f -exec chmod u=rw,g=r,o=r {} \;        asettaa tiedostoille 644
    • Ja jos mikään ei auta niin aja /drupal -hakemistossa ylläolevat komennot ja tiedostojärjestelmä saa arvot 644 755.
    • Aiheita jotka eivät toimineet 24.9.2013 Drupal 7 tehdyssä ajossa kuten Drupalin em. sivulla oli neuvottu, mutta saatiin korjattua:
      • Permission Denied (korjaus neuvottu ylempänä)
      • Teema hävisi
      • Taustan tummennus häviää (overlay). Kokeile toimiiko muulla selaimella. Jos toimii muutoin, mutta ei esim. Safarissa, poista Safarin asetuksista tämän sivuston eväste ja lataa sivu uudestaan. Tarkista tiedosto-oikeudet /modules/overlay ja ulos-sisäänkirjautuminen.
      • Kaikki ikonit katosivat. Löytyy mm. /misc-kansiosta ja moduuleista
      • IMCE ei toiminut
      • Colorbox tausta hävisi ja kehykset ym.
      • Plup kuvakkeet hävisivät

Yksityiset tiedostot[muokkaa]

  • Yksityisen tiedostojärjestelmän polku eli Private files asetetaan asetuksissa esimerkiksi ../../private jolloin kansio sijatisee /drupal -kansion ulkopuolella eli jos drupal on asennettu public_html/drupal niin private olisi tälläin yhden ylempänä eli samalla tasolla hierarkisesti public_html -kansion kanssa.
    • Kansion oikeudeksi asetetaan: 755 (ilmeisesti)
    • Yksityiseen kansioon tallennetaan lisäämällä haluttuun sisältötyyppin uusi kenttä, jossa valitaan tallennuskohteeksi Yksityiset tiedostot
    • Tiedostopäätteet, jotka ovat käytettävissä määritellään sisältötyyppikohtaisesti kohdassa Rakenne > Sisältptyypit > sisälötyypin nimi > hallinnoi kenttiä > muokkaa

Arkisto[muokkaa]

Safari[muokkaa]

Safari selaimen käyttäminen Drupal -ohjelman kanssa.

Xstandard[muokkaa]

http://drupal.org/project/xstandard

Huomioita[muokkaa]

Kuvien lataaminen selaimen kautta vaatii Pro-version

Asennus[muokkaa]

  • Lataa plug-in sivulta. Lopeta kaikki internet selaimet ja asenna ohjelmisto.
  • Lataa Xstandard moduuli. Pura se ja siirrä drupalin moduulihakemistoon
  • Kytke Xstandard moduuli päälle sivujenhallinasta moduuli-kohdasta
  • Sivuston ylläpitoon ja sivujen eri kohtiin, joissa on jotain kenttiä joita voi muokata ilmestyy lauseita xstandard... Niissä on mainittu esimerkiksi edit-body, joka täytyy käydä laittamassa asetukset kohdassa xstandard kohdassa perusasetusten ylimpään Fields ruutuun. Tällöin kun tavallisesti painetaan sivua muokatessa edit välilehteä, niin Xstandard alkaa toimimaan. Jos mitään ei ole kenttäruutuun lisätty, xstandard ei toimi.