Wikikkosysop: /* Yleistä */

2024-11-23T17:11:05Z

Yleistä

← Vanhempi versio		Versio 23. marraskuuta 2024 kello 20.11
Rivi 3:		Rivi 3:

	: Drupalin pääsivu Wikikossa on [[Drupal]].		: Drupalin pääsivu Wikikossa on [[Drupal]].
	: Wikikosta löytyy myös aiheeseen liittyviä sivuja kuten [[PHP]] ja [[~~PHP ja~~ MySQL]].		: Wikikosta löytyy myös aiheeseen liittyviä sivuja kuten [[PHP]] ja [[MySQL]].
	: [https://drupal.org/documentation/develop Drupal.org sivuston ohje, jota tällä sivulla on pääasiallisesti käytetty].		: [https://drupal.org/documentation/develop Drupal.org sivuston ohje, jota tällä sivulla on pääasiallisesti käytetty].
	: [https://drupal.org/node/23789 Drupalin kehitykseen osallistuminen]		: [https://drupal.org/node/23789 Drupalin kehitykseen osallistuminen]

imported>WikikkoSysop: 1 versio tuotiin

2016-09-03T14:33:36Z

1 versio tuotiin

Uusi sivu

==Yleistä==
Aika ryhtyä kehittäjäksi (developer) ja ottaa askel syvemmälle kotisivujen julkaisujärjestelmiin? Drupal on ohjelmoitu käyttämällä [[PHP]] kieltä.

: Drupalin pääsivu Wikikossa on [[Drupal]].
: Wikikosta löytyy myös aiheeseen liittyviä sivuja kuten [[PHP]] ja [[PHP ja MySQL]].
: [https://drupal.org/documentation/develop Drupal.org sivuston ohje, jota tällä sivulla on pääasiallisesti käytetty].
: [https://drupal.org/node/23789 Drupalin kehitykseen osallistuminen]

===Ohjeita===
: [https://drupal.org/documentation Dokumentaatio]
: [https://drupal.org/irc IRC]. [http://limechat.net/mac/ LimeChat ohjelma Mavericks käyttöjärjestelmälle].
: [https://drupal.org/forum Keskustelufoorumi]

==Ohjelmointiympäristön asettaminen==
: [https://drupal.org/node/147789 Ohjeiden lähde]

===Selain===
* Firefox on suositeltava selain.
** [https://addons.mozilla.org/fi/firefox/addon/firebug/ Firebug] ja [https://addons.mozilla.org/en-US/firefox/addon/drupal-for-firebug Drupal for Firebug -lisäosa] ja [https://drupal.org/project/drupalforfirebug Drupaliin asennettava moduuli] yhdessä. [http://drupalforfirebug.chapterthree.com/tests Pikaohje välilehdistä]
** [https://drupal.org/project/devel Devel moduuli] lisää esimerkiksi tietokannasta haut Firebug lisäosaan
** Muita YSlow, Page Speed, FireFTP, Web Developer Extension
** API:en ohjeita tarvitaan, ainakin aluksi, ja niiden etsimistä voi helpottaa seuraavasti: http://api.drupal.org/api/search/ > Firefoxin yläpalkin hakuruudun vasemmassa reunassa on logo, yleensä Googlen, valitse se > Valitse Lisää "Drupal API Drupal 7" Nyt voit hakea suoraan apia hakusanalla.
** [http://www.greasespot.net/ Greasemonkey] avulla voit muokata nettisivujen ulkoasua suoraan selaimesta ohittaen Drupalin asettaman.
* Safarin suhteen täytyy olla varovainen, koska saattaa olla jossain tapauksissa että etsit virhettä muualta, vaikka kyseessä on Safarin toimimattomuus. Safarilla on myös ikävä tapa ajoittain kaatua. Safari sisältää kehitystyökalun valmiina, mutta lisäosana voidaan liittää Firebug Lite. [https://drupal.org/project/firebug_lite Drupal versio Firbug Lite:sta].

===Editorit===
* Hiiren jättäminen vähemmälle lisää nopeutta, suositeltavia ovat esimerkiksi: [[Emacs]] ja Vi ja VIM
** [https://drupal.org/node/59868 Emacs säätäminen Drupaliin]
* [http://www.eclipse.org/ PHPeclipse] ehkä ilmaisista suosituin. PhpStorm on kaupallinen IDE eli graafisella käyttöliittymällä.
====OS X, Xcode 5====
* Xcodessa voit luoda projektin joka sisältää esimerkiksi koko drupalin asennuskansion. Pääset tällöin suoraan avaamaan tiedostot editorii hakemistopuusta ja tallentamaan ne.
** File > New > Project... > OS X Other > Empty > Next
** vasemmasta alakulmasta + > Add Files to "nimi"... ja lisää drupalin asennuskansio tai se kansio minkä tiedostot haluat suoraan Xcodessa käyttöön.
* Xcode > Preferences... > Text Editing > Indentation > säädä välit 2
* Tiedostot saa aukeamaan Xcode:ssa, asettamalla .module, .info, .inc, .install Finderin tiedoston tiedot toiminnolla avautumaan Xcodessa.
* Koska kielenä on PHP, Xcodessa tekstin saa värjäytymään Editor > Syntax Coloring > PHP. (highlight syntax)
: http://industriousone.com/blog/xcode-drupal HUOM! Tämä on Xcode 3 -ohje.
: https://drupal.org/project/coder
: [https://drupal.org/node/805140 OS X]

===Debugger===
Hyvällä debuggerilla pystyt seuraamaan joustavasti php -ohjelman suoritusta.
* [https://drupal.org/node/260854 Xdebug]

===Pääteohjelmat===
Esimerkiksi käyttöjärjestelmän oma tai Filezilla, Cyberduck, PuTTY

===Vertailuohjelmat===
diff ja merge
: http://kdiff3.sourceforge.net/

===Tietokantatyökalut===
Esimerkiksi phpMyAdmin. Katso myös Firefox lisäosat liittyen tietokantaan.

===Drupal ja tietokanta testaukseen===
Uusia moduuleita, ovat ne sitten Drupalin sivuilta ladattuja tai itse tekemiä ei tule tai ei ainakaan tulisi testailla tuotannossa eli muiden käyttäjien käyttämässä Drupalissa. Tarvitset siis joko "kotitietokoneelle" tai palvelimelle toisen Drupal asennuksen ja sille oman tietokannan tai saman tietokannan eri taulut. Yksi vaihtoehto on lähteä puhtaalta pohjalta asentamalla Drupal tai kopioimalla toinen, esimerkiksi julkaistu sivusto pohjaksi. Katso uuden Drupalin asennusohje sivulta [[Drupal]]. [https://drupal.org/creating-drupal-test-sites Toinen vaihtoehto]. [https://drupal.org/node/119752 Tässä kolmas vaihtoehto]. [https://drupal.org/node/120627 Tässä neljäs vaihtoehto eli Drupalin siirto.] Valmiita paketteja ovat esimerkiksi DAMP, WAMP tai MAMP. Kun drupal asennetaan "kotikoneelle" ei tarvitse huolehtia internetyhteydestä, mahdollisista tietoturva-aukoista joita ohjelmoitaessa voi syntyä tai jatkuvasta ftp-latauksesta palvelimelle. Lisätietoa ja asennusohjeita esim. kohdassa Ohjeita olevasta dokumentaatio-linkistä.

===Tietokannan varmuuskopiointi===
====phpMyAdmin====
: https://drupal.org/node/120630

===Synkronointi paikallisen ja etäkoneen välillä===
: https://drupal.org/node/120617

===Virheilmoitukset===
Virheiden löytämistä helpottaa kun asettaa virheilmoitukset ilmestymään näytölle. '''Muista''' poistaa kaikki seuraavat asetuket kun sivusto asetataan julkisesti esille.
* settings.php tiedostoon lisätään seuraavat rivit:
<pre>
error_reporting(E_ALL);
ini_set('display_errors', TRUE);
ini_set('display_startup_errors', TRUE);
</pre>
* Kytke päälle Ylläpito > Asetukset > Kehitys > Loggaus ja virheet > Kaikki viestit
* TAI kytke PHP:n php.ini tiedostossa E_ALL | E_STRICT

===Välimuistin kytkeminen pois päältä===
Kehitysvaiheessa välimuistin pois päältä kytkeminen saattaa olla järkevää, jotta Drupal reagoi muutoksiin välittömästi. Mutta tuotantovaiheessa välimuisti pidetään yleensä päällä.
* Lisää settings.php tiedostoon seuraava:
<pre>
if (!class_exists('DrupalFakeCache')) {
$conf['cache_backends'][] = 'includes/cache-install.inc';
}
// Default to throwing away cache data
$conf['cache_default_class'] = 'DrupalFakeCache';
// Rely on the DB cache for form caching - otherwise forms fail.
$conf['cache_class_cache_form'] = 'DrupalDatabaseCache';
</pre>

===Drupalin säätäminen nopeammaksi===
: https://drupal.org/node/1722250

===Moduuleita kehittäjille===
: https://drupal.org/node/206773
: [https://drupal.org/node/2112911 drupal notebook]

===Sähköposti===
"Kotikoneella" sähköpostien lähettäminen saattaa vaatia hiukan säätämistä.
: https://drupal.org/node/201981 Kokeilemisen arvoinen voi olla esim. kohta Mail to Database eli settings.php tiedostoon rivi $conf['mail_system'] = array('default-system' => 'HelperDebugMailLog'); jonka jälkeen sähköpostit löytyvät Raportit > loki

===Drush===
: https://github.com/drush-ops/drush

===git ja patches===
Moduulien pohjana omaan tarkoitukseen kannattaa tietysti käyttää olemassaolevia moduuleita. Kun kirjoitat uuden toiminnon olemassa olevaan toimintoon tai korjaat virheen sen julkaisu yhteisölle tapahtuu patch -toiminnon avulla. The task is to use Git, drupal.org's version control system, to clone the repository, make a branch, and after adding the 'More link' functionality, to roll a patch. If you come up with something beyond the 'More' link, add that, too. Then post your patch in the 'Current content' issue queue. Next, review one of the other patches in the queue on a different Git branch. If it works right, mark it Reviewed & Tested by the Community (RTBC). (For major patches, this status is hard to obtain, so be careful with it outside this sandbox.) If everyone that contributes a patch also reviews one, then your patch will be reviewed as well.<ref> https://drupal.org/node/1134754</ref>
: [https://drupal.org/patch Patches]
: [https://drupal.org/node/1134754 Ohje]
: [https://drupal.org/documentation/git Git ohje]

=== Git asennus ===
# Ota käyttöön Git Drupal.org sivuston käyttäjätilissäsi.
# Asenna Git tietokoneeseesi, https://www.drupal.org/documentation/git/install
## Git -ohjelma asennetaan pääte-ohjelman kautta käytettäväksi tai GitHub sovellus.
# Luo .gitconfig ja .gitignore tiedostot. Esim. OSX:ssä käyttäjähakemistoosi. https://www.drupal.org/documentation/git/configure
# Siirry hakemistoon, johon haluat kopion Drupalin palvelimelta ladattavan.
# Lataa kopio Drupalista, esim. git clone --branch 8.x http://git.drupal.org/project/drupal.git
: https://www.drupal.org/documentation/git
: Ohje https://www.drupal.org/node/3060/git-instructions/7.x/nonmaintainer

==== GitHub ====
GitHub.com kotisivuilta voi suoraan lisätä omaan koneeseen asennettuun GitHub-sovellukseen Clone in Desktop -linkin avulla.

==Käyttöliittymä standardit Drupalissa==
: https://drupal.org/ui-standards

==Drupalkoodin standardit==
Kirjoitettaessa Drupal koodia tulee noudattaa sen hetkisiä [https://drupal.org/node/318 koodauksen standardeja]. Esimerkit ovat oheisesta ohjeesta 18.1.2014.
* rivin pituus enintään 80 merkkiä, sallien poikkeukset
* sisennys 2 välilyöntiä, ei koskaan sarkainta
* ei välilyöntiä rivin lopussa
* ehtoja ei jaeta useammille riveille
* koodin ei tarvitse olla äärettömän tiivistä vaan ennemmin selkeää
* kommentointi on tärkeä osa ohjelmointia. Moduulit kirjoitetaan lähtökohtaisesti englannin kielellä. Rivin lopussa kommentti //Kommentti tähän. Kommentit loppuvat pisteeseen ja alkavat isolla kirjaimella. # -merkkiä ei tule käyttää kommentoinnissa.
/**
* Tekstiä
*/

/**
* @file
* Tekstiä
*/
* ' -merkkiä suositellaan paitsi "Vihreän vaa'an paino." ja <pre>"<h2>$header</h2>"</pre>
* <?php eli käytä php sanaa. Jätä pois loppu ?> koska se voi aiheutta ongelmia tietyissä palvelimissa rikkoen HTTP headerit.
* <?php print $muuttuja; ?> eli käytä puolipistettä
* + - * / = .= != == ** ++ -- > < ym. erotetaan yhdellä välilyönnillä kummallakin puolen merkkiä
* (int) $muuttuja eli välissä yksi välilyönti

* ohjetiedostot ISOILLAKIRJAIMILLA.txt
* tiedostot päättyvät \n
* tekstitiedostot päättyvät yhteen tyhään riviin \n

* funktiot ja muuttuja pienillä kirjaimilla, sanat erotetaan alaviivalla. Funktioilla lisäksi ryhmä/moduuli etuliite
* kiinteät muuttujat isoilla kirjaimilla alaviivalla erotettuna, myös esm. TRUE
* $muuttuja = 'Foo' . $bar; eli välilyönti pisteen kummallakin puolen
* $muuttuja = "Foo $bar";
* globaalit muuttujat alkavat alaviivalla _moduulinnimi_muuttujannimi
* funktiokutsun muoto $muuttuja = nimi($muuttuja1, $muutuja2);
* funktiokutsussa oletusarvo argumenttilistan loppuun, aina pyrittävä palauttamaan järkevä arvo
* oliota muodostettaessa $olio = new LuokanNimi($muuttuja1, $muuttuja2);
** $muuttuja = 'LuokanNimi'; ja sitten luodaan $olio = new $muuttuja();
** oliot katso https://drupal.org/node/608152
* Taulukot $muuttuja = array('teksti1', 'teksti2', 'foo' => 'bar');
** jos ylittää 80 merkkiä, pilkotaan yksi per rivi alkaen aina kahdella välilyönnillä ja pilkku rivin lopussa
* käytä epätavallisissa tilanteissa require_once() ja tavallisissa include_once()
** include_once ./includes/moduulini_tiedosto.inc eli aloita aina pisteellä polku
** Drupal 7:ssä: require_once DRUPAL_ROOT . '/' . variable_get('cache_inc', 'includes/cache.inc');

<pre>
<?php
if (!defined('MAINTENANCE_MODE')) {
define('MAINTENANCE_MODE', 'error');
}
?>
</pre>
* kirjoita elseif yhteen, käytä aina aaltosulkeita
if (ehto1 || ehto2) {
toiminto1;
}
elseif (ehto3 && ehto4) {
toiminto2;

<pre>
switch (ehto) {
case 1:
toiminto1;
break;

default:
oletustoiminto;
}
</pre>

<pre>
do {
toiminnot;
} while ($ehto);
</pre>

<pre>
<?php if (!empty($muuttuja)): ?>
<p><?php print $muuttuja; ?></p>
<?php endif; ?>

<?php foreach ($muuttuja as $muuttuja): ?>
<p><?php print $muuttuja; ?></p>
<?php endforeach; ?>
</pre>

==Moduuli==
Katso sivu [[Drupal ohjelmointi moduuli]].

==Teema==
Katso sivu [[Drupal ohjelmointi teema]].

==Testaus==
Drupal sisältää Simple Test PHP Libraryyn perustuvan testauksen. Testaus kohdistuu lähinnä käyttöliittymään. Hyvä testi syntyy kun tiedetään mitä täytyy testata. [https://drupal.org/simpletest-tutorial-drupal7 Lisätietoa aiheesta].
Se kytketään päälle normaalisti moduulina kohdasta Testing.
: https://drupal.org/node/1128366

[[Luokka:Tietokoneet]]

Drupal ohjelmointi - Muutoshistoria

Wikikkosysop: /* Yleistä */

imported>WikikkoSysop: 1 versio tuotiin