A-Eskwiki - User contributions [en]

Ouderdag mogelijk maken

2018-06-26T16:09:03Z

Ludop: kwerrie code

[[Category:WebCie]]
Vele jaren wordt er een ouderdag georganiseerd. Waarschijnlijk lees je dit omdat de ouderdag commissie heeft gevraagd voor de contact gegevens van 1e en 2e jaars. Dit gaat als volgt:

* Bekijk de kwerrie die hieronder staat.
* Kopieer de kwerrie naar je plakbord.
* Ga naar [admin.a-eskwadraat.nl] en log in
* Voer de kwerrie uit
* Exporteer de kwerrie naar CSV en klaar is kees.

== Ouderdag CSV kwerrie ==

<syntaxhighlight lang=sql>
SELECT Persoon.contactID, Persoon.voornaam, Persoon.bijnaam,
Persoon.voorletters, Persoon.geboortenamen, Persoon.tussenvoegsels,
Persoon.achternaam, Persoon.titelsPrefix, Persoon.titelsPostfix,
Persoon.geslacht, Contact.email, ContactAdres.*
FROM Lid
JOIN Persoon ON Lid.contactID = Persoon.contactID
JOIN Contact ON Contact.contactID = Lid.contactID
LEFT JOIN ContactAdres ON ContactAdres.contact_contactID = Lid.contactID
WHERE Persoon.overleden = 0
AND (
SELECT MIN(datumBegin)
FROM LidStudie
JOIN Studie ON Studie.studieID = LidStudie.studie_studieID
WHERE
LidStudie.lid_contactID = Lid.contactID
AND fase = 'BA'
) >= '2016-09-01'
ORDER BY `Lid`.`contactID` ASC;
</syntaxhighlight>

In 2017/2018 waren de ouders van een overleden persoon gemaild. Voorkom dit!
--[[User:Ludop|Ludop]] ([[User talk:Ludop|talk]]) 18:09, 26 June 2018 (CEST)

Kaartjes bij activiteiten

2018-05-29T19:58:33Z

Ludop: qr-codes scannen handleiding

== QR-codes scannen ==

Om een QR-code van kaartjes bij een activiteit te scannen, moet eerst de kaartsoort op "PERSOONLIJK" staan.

Vervolgens moet je naar de activiteit pagina gaan.
Hier is een knop te vinden met "Scanbare kaartjes activeren". Klik dit.

Dit bevat de "master qr-code", die belangrijk is om qr-codes te gaan scannen. Print deze dus 2x uit voor een activiteit begint en neem deze mee want deze is nodig om die van andere te scannen!

--[[User:Ludop|Ludop]] ([[User talk:Ludop|talk]]) 21:58, 29 May 2018 (CEST) momenteel lijkt het alsof deze niet nodig is, en dat je gewoon qr-codes direct kunt gaan scannen.

Daarna, moet je de scan-app gebruiken. Dit is een speciale app, die [https://home.a-eskwadraat.nl/~floriann/kaartjesscanner.apk hier] te downloaden is.
Als je hem niet kan installeren, verwijder de "A-Appkwadraat", deze gebruikt hetzelfde certificaat. Als het nog niet werkt, moet je toestaan apps te installeren uit onbetrouwbare bron (zoek op internet, iets met USB debugging?).

In de app, ga je naar de activiteit en in het menu ga je naar "Scan tickets". Hier kun je nu kaartjes scannen.

Op de site worden van kaartjes ook aangegeven of ze ooit gescant zijn.
Succes ermee!

Vraag webcie dingen als iets in de fik vliegt.

== QRCode opnieuw mailen ==

Om de zoveel tijd krijgt de WebCie een mailtje van iemand dat de iDEAL-betaling voor een activiteitkaartje geslaagd was maar dat ze de aparte mail met kaartje niet hebben ontvangen. We weten nog niet precies waarom dit komt, maar we vermoeden dat een spamfilter te agressief de kaartjesmails opeet (al is het voorgekomen dat redelijk capabele gebruikers ze niet in de spamfolder tegenkwamen, dus het mysterie gaat door...)

Wat je dan kunt doen is checken of de IDEALTransactie inderdaad succesvol was, zo ja de code(s) opzoeken tussen de iDealKaartjeCode  en een mailtje sturen naar de arme kaartjesloze persoon. Probeer zoiets te schrijven:

<pre>
Beste [PERSOON],

Ik zie inderdaad een transactie op [DATUM], maar
[ die lijkt succesvol verstuurd te zijn | de mail is naar een ander e-mailadres verstuurd | de mail is compleet foutgegaan ]
(heb je al tussen de spam gekeken?).
De kaartjes die bij deze transactie horen, heb ik als attachment toegevoegd.
De geheime codes, voor het geval de plaatjes niet werken, zijn [B4N44N] en [W4TL3UKS].
Laat het ons weten als je nog problemen hebt.

Met vriendelijke groeten,

[AFZENDER]
namens de WebCie
[ATTACHMENTS MET QR-CODE VOOR KAARTJES]
</pre>

De qr-codes kun je genereren met het scriptje <code>scripts/create-qr-kaartje.php</code>, die je op de <code>vm-www-debug</code> kunt draaien. Het neemt twee command-line argumenten: geheime code van een ontbrekend kaartje en activiteitnummer. Op stdout verschijnt een PNG-bestand met je kaartje. Voorbeeldaanroep:

<pre>
~/wwwdebug/scripts$ ./create-qr-kaartje.php B4N44N 1337 > ~/troep/qr-kaartje-1.png
</pre>

Zie ook [https://www.a-eskwadraat.nl/Service/Bugweb/6956/ bug #6956]

[[Category:WebCie]]
[[Category:HowTo]]

Kaartjes bij activiteiten

2018-05-29T19:49:01Z

Ludop: Ludop moved page Activiteitkaartje mailen to Kaartjes bij activiteiten: Behalve mailen wordt ook scannen uitgelegd.

Om de zoveel tijd krijgt de WebCie een mailtje van iemand dat de iDEAL-betaling voor een activiteitkaartje geslaagd was maar dat ze de aparte mail met kaartje niet hebben ontvangen. We weten nog niet precies waarom dit komt, maar we vermoeden dat een spamfilter te agressief de kaartjesmails opeet (al is het voorgekomen dat redelijk capabele gebruikers ze niet in de spamfolder tegenkwamen, dus het mysterie gaat door...)

Wat je dan kunt doen is checken of de IDEALTransactie inderdaad succesvol was, zo ja de code(s) opzoeken tussen de iDealKaartjeCode  en een mailtje sturen naar de arme kaartjesloze persoon. Probeer zoiets te schrijven:

<pre>
Beste [PERSOON],

Ik zie inderdaad een transactie op [DATUM], maar
[ die lijkt succesvol verstuurd te zijn | de mail is naar een ander e-mailadres verstuurd | de mail is compleet foutgegaan ]
(heb je al tussen de spam gekeken?).
De kaartjes die bij deze transactie horen, heb ik als attachment toegevoegd.
De geheime codes, voor het geval de plaatjes niet werken, zijn [B4N44N] en [W4TL3UKS].
Laat het ons weten als je nog problemen hebt.

Met vriendelijke groeten,

[AFZENDER]
namens de WebCie
[ATTACHMENTS MET QR-CODE VOOR KAARTJES]
</pre>

De qr-codes kun je genereren met het scriptje <code>scripts/create-qr-kaartje.php</code>, die je op de <code>vm-www-debug</code> kunt draaien. Het neemt twee command-line argumenten: geheime code van een ontbrekend kaartje en activiteitnummer. Op stdout verschijnt een PNG-bestand met je kaartje. Voorbeeldaanroep:

<pre>
~/wwwdebug/scripts$ ./create-qr-kaartje.php B4N44N 1337 > ~/troep/qr-kaartje-1.png
</pre>

Zie ook [https://www.a-eskwadraat.nl/Service/Bugweb/6956/ bug #6956]

[[Category:WebCie]]
[[Category:HowTo]]

Activiteitkaartje mailen

2018-05-29T19:49:01Z

Ludop: Ludop moved page Activiteitkaartje mailen to Kaartjes bij activiteiten: Behalve mailen wordt ook scannen uitgelegd.

#REDIRECT [[Kaartjes bij activiteiten]]

Ouderdag mogelijk maken

2018-04-23T17:05:15Z

Ludop:

[[Category:WebCie]]
Vele jaren wordt er een ouderdag georganiseerd. Waarschijnlijk lees je dit omdat de ouderdag commissie heeft gevraagd voor de contact gegevens van 1e en 2e jaars. Dit gaat als volgt:

* Bekijk de kwerrie in het bestand <code>ouderdag-leden.sql</code> onder de webcie homedir.
* Kopieer de kwerrie naar je plakbord.
* Ga naar [admin.a-eskwadraat.nl] en log in
* Voer de kwerrie uit
* Exporteer de kwerrie naar CSV en klaar is kees.

Ouderdag mogelijk maken

2018-04-23T17:04:38Z

Ludop: Beschrijving voor faciliteren ouderdag.

Vele jaren wordt er een ouderdag georganiseerd. Waarschijnlijk lees je dit omdat de ouderdag commissie heeft gevraagd voor de contact gegevens van 1e en 2e jaars. Dit gaat als volgt:

* Bekijk de kwerrie in het bestand <code>ouderdag-leden.sql</code> onder de webcie homedir.
* Kopieer de kwerrie naar je plakbord.
* Ga naar [admin.a-eskwadraat.nl] en log in
* Voer de kwerrie uit
* Exporteer de kwerrie naar CSV en klaar is kees.

Bestuurswissel

2018-04-06T12:49:31Z

Ludop: Kandidaatbestuur procedure

[[Category:WebCie]]

Dit is het stappenplan wat elk jaar bij een bestuurswissel uitgevoerd moet worden. Dit is zo snel mogelijk na de Wissel-AV die in het begin van een nieuw collegejaar plaatsvindt.

Er moeten zowel dingen op de site gedaan worden als in de code.
Natuurlijk moet de sysop ook dingen op het systeem regelen maar dat is hun probleem.

=== Website frontside ===

# Maak een nieuwe commissie aan met login <code>bestuurjjjj</code>.
# Voeg alle mensen die daar in horen toe aan deze commissie.
# Maak een publisher pagina aan voor het huidige bestuur (<code>bestuurjjjj</code>).
# Update de redirects in benamite (<code>/Vereniging/Bestuur</code> en <code>/Vereniging/Commissies/Bestuur</code>)
# Dubbelcheck even of alles nog werkt.

===Backside===
# Check of onderstaande dingen al meteen moeten worden aangepast, het kan best zijn dat een (oud)bestuurslid nog tijdelijk bestuursrechten nodig heeft voor de laatste inwerking of afronding van werkzaamheden.
# Ga naar het BESTUUR DATA deel in <code>space/specialconstants.php</code> en verander alle data hier aan.
#:* Vul bij <code>BESTUURLOGINNAAM</code> wederom <code>bestuurjjjj</code> in.
#:* Bij mails van de boekencommissaris en de secretaris (gegenereerd door de website) moet natuurlijk de naam staan van het verantwoordelijke bestuurslid. Daarom moet je deze namen invullen in respectievelijk <code>Willem Hulst</code> en <code>Tara Fokker</code>
#:* Vervang de BESTUUR array. Zie <code>/space/classes/BestuursLid.php</code> voor de parameters van de constructor.
# Verander de regel met <code>KANDIDAATBESTUURLOGINNAAM</code> (onder het bestuurdata-blok) in commentaar door "//" voor de regel te proppen.

== Kandidaatbestuur aanmaken ==

Het kandidaatbestuur kan aangemaakt worden door een commissie te maken op de site op dezelfde manier als de website frontside. Alle afgelopen jaren is de conventie <code>kbjjjj</code> gebruikt. Doe dit ook, en vul dit in bij <code>KANDIDAATBESTUURLOGINNAAM</code> en zorg ervoor dat het geen commentaar-regel is.

User:Ludop

2018-04-06T12:42:10Z

Ludop: Created page with "Zie https://www.a-eskwadraat.nl/Leden/11158/. Zo kun je genoeg stalken!"

Zie https://www.a-eskwadraat.nl/Leden/11158/. Zo kun je genoeg stalken!

Wishlist

2018-04-06T12:41:27Z

Ludop: mijn wishlist

Hier kan je dingen neerzetten die je graag zou zien in, of doen met, de code of website. Dit kunnen dan een soort persoonlijke TODO's of ideëen zijn, of iets wat meer is van het niveau "herschrijf alles in Idris", i.e. lulz.

= [[User:Daanr|Daan]] =

Ongeveer op lexicografische volgorde van 'realistisch, belangrijk' naar 'P = NP, niet zo belangrijk'.

* Test meer dingen. (Wordt aan gewerkt.)
* Zorg dat de PromoCie weer toegang heeft tot de vertaalstrings op de een of andere manier
* Upgrade naar PHP 7.
* Upgrade naar PostgreSQL.
* Maak de dia2php netter, i.e. minder met teringlange strings met allemaal tabs erin. Iets met een expliciete AST en quasiquoting ofzo.
* Gebruik Dia niet meer als model-definitie format, want het is echt niet chill voor version control.
* Gooi FotoWeb weg ofzo.
* Maak Benamite/WhosWho4 chiller om te gebruiken. Vooral op het gebied van routing. Bijvoorbeeld dat je expliciet in een controllerfunctie kan zeggen wat voor parameters erin je parameters moeten. Zie: Flask.
* Test controllerfuncties á la QuickCheck. Dus dan moet je een manier vinden om URL parameters te... parameteriseren. En geen idee of een QuickCheck-achtige library voor PHP bestaat, en zo nee, hoe die eruit zou moeten zien.
* Meer DevOps dingen, makkelijker je eigen developer env en de production env draaien.
* Maak alles een tikje meer microservice-achtig, door ledenbeheer e.d. in een kern-API te stoppen, en dan 'apps' op basis van die (REST) API te implementeren. Gevolg hiervan is dat je dan ook andere talen dan PHP kan gebruiken, zonder dat je alles hoeft te herschrijven!
* Waarschijnlijk samen met bovenstaand item: doe leuke & fijne frontend dingen met Elm/PureScript/TypeScript/WebAssembly.
* C O N T A I N E R I Z A T I O N want dat is ''web scale''
* Herschrijf de website in de toffe Haskell-en-Python-hadden-een-baby taal die [[User:Timb|Tim]] ooit gaat maken.
* Bewijs dat P = NP.
* Verander PHP in een goede taal.

= [[User:Timb|Timb]] =

* Een fijn (unit)testsysteem. (werk ik aan!)
* HTML-objecten maar dan voor allerlei HTML/XML die in Page-objecten geproduceerd wordt.
* Upgrade naar PHP 7.
* Upgrade naar PostgreSQL.
* Continuous integration.
* De meeste functies zijn zo goed als puur, en de functies die niet puur zijn komen niet in een View voor.
* 100 % code coverage.
* Decorator-achtige constructies voor requireAuth enzo.
* dia2php poept volautomatisch een hele CRUD-app uit.
* Herschrijf de website in Swail, de toffe Haskell-en-Python-hadden-een-baby programmeertaal die je helpt te zeggen wat je bedoelt (en die syntactische whitespace heeft!).
* Volledig automatisch je testomgeving maken.
* Een formeel bewijs dat de website featurecompleet is.
* Onze eis is niets meer, maar kan ook niets minder zijn, dan het Goede Leven voor elk persoon.
* Bewijs dat P =/= NP.

= [[User:Ludop|Ludop]] =

* Een huisje op de bahama's.

[[Category:WebCie]]

Fotocache

2018-04-06T12:37:52Z

Ludop:

[[Category:WebCie]]
Hoewel de map staat in <code>/srv/cache</code> is het beter om '''niet''' de fotocache leeg te gooien: hier worden namelijk de verkleinde versies van foto's op Fotoweb opgeslagen. Het script <code>/scripts/cron/fw_precreatethumbs.php</code> zorgt elke nacht ervoor dat deze cache gevuld wordt met alle foto's van Fotoweb.

Mail sturen vanaf de site

2018-04-06T12:36:55Z

Ludop: Email optie toegevoegd

Als je een mailtje wil sturen vanaf de site, bijvoorbeeld bugberichten, dan heb je de functie <code>sendmail</code> of de klasse <code>Email</code> nodig.

Tijdens emails sturen wordt er heel veel escaping magie gebruikt omdat er veel regels zijn over de encoding en gebruik van UTF-8 karakters. Verwacht hierdoor dat je de gehele sendmail-code niet zult begrijpen. --[[User:Ludop|Ludop]] ([[User talk:Ludop|talk]]) 14:36, 6 April 2018 (CEST)

== sendmail ==

De functie sendmail zit in space en verwacht de volgende parameters:

<pre>
www/space/sendmail.php:18:function sendmail($from, $to, $subject, $text, $replyto='', $extra='', $bounceto='', $html = false)
</pre>

== space/classes/Email ==

Een andere optie is gebruik te maken van de Email klasse. Deze is veel mooier en kan goed overweg met HTML.
Afzenders/geadresseerden kunnen opgegeven worden met respectievelijk <code>setFrom</code> en <code>setTo</code>. Deze verwacht een Contact, Bug, Commissie of BestuursLid.

Email gebruikt sendmail nog.

[[Category:WebCie]]
[[Category:HowTo]]

App

2018-04-06T12:30:45Z

Ludop:

[[Category:WebCie]]
Sinds kort hebben we ook een eigen A-Appkwadraat. Dit is een android-app en de code staat in Git onder <code>app</code>.

Het ontwikkelen van de app is/wordt gedaan door [[User:floriann]] met behulp van [https://developer.android.com/studio/install.html Android Studio].

Er is ooit gesproken om een appcie op te starten die het beheer van de app onder zijn hoede nam, maar dit is (nog?) niet uitgevoerd.

App

2018-04-06T12:30:26Z

Ludop: SVN -> Git

[[Category:WebCie]]
{{Outdated}}
Sinds kort hebben we ook een eigen A-Appkwadraat. Dit is een android-app en de code staat in Git onder <code>app</code>.

Het ontwikkelen van de app is/wordt gedaan door [[User:floriann]] met behulp van [https://developer.android.com/studio/install.html Android Studio].

Er is ooit gesproken om een appcie op te starten die het beheer van de app onder zijn hoede nam, maar dit is (nog?) niet uitgevoerd.

Bestuurswissel

2018-04-06T12:22:36Z

Ludop: /* Backside */

Bestuurswissel

2018-04-06T12:22:02Z

Ludop: Wijzigingen aan bestuurs-data in code toegepast naar aanleiding van de html-uitzwaaimail die vanaf de secretaris wordt gestuurd met de Email class

WebCie Databases

2018-03-26T13:50:10Z

Ludop:

De WebCie runt een paar databases waarin alle websitedata (dus ook ledendata, en transactiedata) staat. Op de [[vm-www]], [[vm-www-debug]] en de [[vm-www-inwerking]] draaien allemaal een databaseserver en dezelfde databasestructuur (modulo updatevolgorde).

== Gebruik in de code ==

De beste manier om kwerries op de databaas te doen is met [[QueryBuilder]]. Dit is een manier om volautomatisch SQL te genereren vanuit object-georienteerde code, zonder dat je bang hoeft te zijn voor injectie enzo.

De belangrijkste database is <code>whoswho4</code>, waar alle [[WhosWho4]]-objecten in staan. Dan zijn er nog <code>benamite</code> voor [[Benamite]] en <code>boeken</code> voor [[Bookweb]].

=== Hoe een db-connectie opgezet wordt ===

In principe zouden dingen als databaseconnectie enzo al geregeld moeten zijn als je controllerfunctie aangeroepen wordt, maak hier dus alleen zorgen over als je ergens in [[space]] bezig bent.

Eerst wordt door [[space]] het bestand [[secret.php]] geladen, waarin gebruikersnaam en wachtwoord voor alle databaseusers staan. Op basis van de functie <code>getLevel</code> worden drie globalen <code>$WSW4DB</code>, <code>$BWDB</code> en <code>$BMDB</code> gemaakt door middel van [https://doxygen-www.a-eskwadraat.nl/classdbpdo.html dbpdo]. Hun memberfunctie <code>q(...)</code> verstuurt een kwerrie naar de desbetreffende databaas.

Dit zorgt er ook voor dat inloggen en uitloggen (en eigenlijk alles wat de auth van de gebruiker aanpast) een refresh vereist voordat alles goed weergegeven kan worden!

== Debugdatabase ==

Op de [[vm-www-debug]] wordt elke nacht een kopietje gemaakt van de livedatabases om op te kunnen debuggen. Deze db's heten <code>test_$BLA</code> waar <code>$BLA</code> staat voor de naam van de originele database.

Om precies te zijn, elke dag wordt <code>scripts/cron/copy_db_to_test_db.sh boeken whoswho4</code> aangeroepen op de live-server (zolang bookweb nog wordt gebruikt met <code>boeken</code>).
Elke maandag ochtend wordt de tabel <code>benamite</code> gekopieerd naar de debug database.
Dit valt terug te vinden in de crontab onder <code>scripts/cron</code>.
--[[User:Ludop|Ludop]] ([[User talk:Ludop|talk]]) 15:50, 26 March 2018 (CEST)

== Aanpassen buiten de code om ==

Heb je een nieuwe klasse gemaakt of een nieuw veld? Dan kun je op [https://pgadmin-debug.a-eskwadraat.nl] (of als je echt PHPMyAdmin nodig hebt [https://admin-debug.a-eskwadraat.nl]) (debugdb) en [https://admin.a-eskwadraat.nl] (livedb) inloggen op localhost met gebruikersnaam root en het databasewachtwoord. Dit wachtwoord vind je in het bestand <code>.my.cnf</code> in de homedir van gebruiker <code>webcie</code>. Als je klaar bent met dit soort wijzigingen, moet je de [[Databasestructuur committen]].

== Migratie naar PostgreSQL ==

MySQL is stiekem best wel slecht, dus we willen graag in plaats daarvan PostgreSQL gebruiken. De migratie gaat ongeveer als volgt.

SSH naar de VM waar de oorspronkelijke database opstaat. Dan doe je ongeveer de volgende stappen (dit is voor de vm-www-debug).
Eerst installeren we Postgres:

<code><pre>
wget https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-6-x86_64/pgdg-centos96-9.6-3.noarch.rpm
rpm -Uvh pgdg-centos96-9.6-3.noarch.rpm
sudo yum update
sudo yum install postgresql96-server postgresql96-contrib
sudo service postgresql-9.6 initdb
sudo service postgresql-9.6 start
sudo chkconfig postgresql-9.6 on
sudo -i
su postgres
psql
</pre></code>

Doe nu <code>CREATE USER</code> voor alle users in je [[secret.php]].

Dan zijn we klaar om de koppeling met PHP te maken:

<code><pre>
sudo yum install php-pgsql
sudo service httpd restart
</pre></code>

Pas <code>/var/lib/pgsql/9.6/data/pg_hba.conf</code> aan zodat je auth method md5 gebruikt.
(De bestanden <code>/usr/pgsql/*</code> slaan nergens op, negeer deze.)

<code><pre>
sudo service postgresql-9.6 restart
</pre></code>

Je zou nu moeten kunnen inloggen met <code>psql --user $BLA -d postgres</code>
en ook op adminer (maar let op dat je een database kiest die bestaat).

=== Data migreren ===
Ruim eerst je DB een beetje op!
(oftewel zorg dat je foreign keys kloppen, dat er geen datums zijn met jaar 0000, maand 00 of dag 00 enzo)

Dit is een volledige migratie, inclusief dbstructuur. Gebruik andere opties voor <code>mysqldump</code> om alleen data te verhuizen.
<code><pre>
mysqldump --compatible=postgresql --user=root --password --default-character-set=utf8 test_whoswho4 > export.sql
python2.7 docs/db_converter.py export.sql pg-export.sql
psql -d test_whoswho4 -U root -f pg-export.sql
</pre></code>

PRO-TIP: pas de relaties eerst handmatig aan, want die zijn niet echt goed over te zetten.

Vervolgens moeten we handmatig alle tabellen die in MySQL een autoincrement hadden, maar waar die kolom niet <code>id</code> heet, in PostgreSQL een sequencenummer geven. Dat ziet er ongeveer zo uit:

<code><pre>
CREATE SEQUENCE IOUBon_bonID_seq;
SELECT setval('IOUBon_bonID_seq', max("bonID")) FROM "IOUBon";
ALTER TABLE "IOUBon" ALTER COLUMN "bonID" SET DEFAULT nextval('IOUBon_bonID_seq');
</pre></code>

Heb je dat allemaal gedaan, dan moet je ook voor alle databaseusers rechten geven:

<code><pre>
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO god;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO ingelogd;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO dibstablet;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO mollie;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO gast;
</pre></code>

Nu moeten we ook nog de rechten overnemen. In MySQL doe je <code>SHOW GRANTS FOR '$USER'@'localhost'</code> voor alle users in de db-wachtwoorden, pas de output hiervan aan tot PostgreSQL-syntax en voer die uit. (Dit is een hoop werk!)

[[Category:WebCie]]

Cron

2018-03-16T12:11:43Z

Ludop: Cronjob aanpassen moet via script install_new_crontab

De cronjobs zijn alle scripts in <code>/scripts/cron</code> die om de <code>$x</code>-tijd uitgevoerd moeten worden.

De lijst van alle jobs die daadwerkelijk uitgevoerd worden staan in het <code>/scripts/cron/crontab_vm-www[|-debug].webcie</code> bestand.

= Formaat =
Schaamteloos uit /etc/crontab gekopieerd:

<pre>
For details see man 4 crontabs
Example of job definition:
.---------------- minute (0 - 59)
| .------------- hour (0 - 23)
| | .---------- day of month (1 - 31)
| | | .------- month (1 - 12) OR jan,feb,mar,apr ...
| | | | .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
| | | | |
* * * * * user-name command to be executed
</pre>

= Nieuwe cronjob =

Als het cronjob bestand hebt aangepast in `scripts/cron`, dan wordt dit nog niet uitgevoerd door de cron.
Hiervoor moet je in deze map het bestand `install_new_crontab_vm-www[|-debug]` uitvoeren onder de gebruiker `webcie`.

[[Category:WebCie]]

PHP-extensies

2017-12-04T22:09:11Z

Ludop: Created page with " == IMAP == We gebruiken de IMAP extensie voor functies als <code>imap_mime_header_decode</code> binnen het <code>mail_process_bug.2</code> script. Om het te installeren mo..."

== IMAP ==

We gebruiken de IMAP extensie voor functies als <code>imap_mime_header_decode</code> binnen het <code>mail_process_bug.2</code> script.

Om het te installeren moet je eerst <code>sudo yum install php-imap</code> draaien op een CentOS systeem. Daarna, moet je apache herstarten: <code>sudo service httpd restart</code>.

[[Category:WebCie]]

Git (WebCie)

2017-06-01T20:14:35Z

Ludop:

Git (wat staat voor "Git") is het bovennatuurlijke systeem waarmee we controle houden op wat er gebeurt met alle WebCie-code. Als WebCie-lid heb je een kopie (een ''checkout'') van het volledige systeem staan op je eigen account (in de map <code>~/wwwdebug</code>). Deze code bepaalt wat jij te zien krijgt in je browser als je naar je persoonlijke debugpagina gaat (lijkt op <code>https://bla-debug.a-eskwadraat.nl</code>). Als je wijzigingen in deze code aanbrengt, veranderen dus alleen de pagina's op jouw persoonlijke debug-omgeving. Dat noemen we een sandbox, het zorgt er voor dat je rustig je code kan ontwikkelen zonder dat de rest van de WWW daar last van heeft. Bovendien is jouw debugpagina alleen benaderbaar door WebCie-leden, dus als je per ongeluk lekkende SQL-queries schrijft is dat geen ramp.

Op deze pagina staat basale info om aan de slag te gaan met Git. Je kan ook in de [https://git-scm.com/book/en/v2 online handleiding] kijken voor meer pro-tips.

De WebCie is onlangs  overgestapt naar Git. Hierbij is ook de svn-geschiedenis gefilterd, dus pas op bij overstappen!

== Workflow ==

Een ding waar je bij git waarschijnlijk aan moet wennen is dat iedereen een eigen idee heeft van de geschiedenis van alle code. Op de server staan een setje commitgeschiedenissen (oftewel branches), en op je debug staat ook zo'n setje. Met een beetje geluk komen ze ook nog overeen, maar dat hoeft dus niet! Er zijn commando's om van iemand anders de geschiedenis overnemen. Dan krijg je een kopietje binnen van hun geschiedenis, maar wordt jouw geschiedenis ''niet'' aangepast! Je hebt bijvoorbeeld de volgende branches, allemaal opgeslagen in je eigen debug:

* master (jouw laatste editie van de livesite)
* develop (jouw eigen editie van de "echte" code)
* feature-watleuks (jouw eigen editie van deze feature)
* feature-zoveel (een feature waarvan de server nog helemaal niet weet dat die bestaat)
* HEAD (wijst naar de laatste commit die bij jou is gebeurd, dus als het goed is de branch waar je nu op werkt)
* origin/master (wat jij denkt dat de servereditie van de livesite is)
* origin/develop (wat jij denkt dat de servereditie van de "echte" code is)
* origin/feature-watleuks (wat jij denkt dat de servereditie van de deze feature is)

Als je <code>git fetch</code> doet, zal git de laatste versie van elke branch van de server opvragen en die bewaren in origin/$branch. Dan kun je die weer in jouw branches stoppen met bijvoorbeeld <code>git merge</code>. Het commando <code>git pull</code> stuurt jouw editie van de huidige branch naar de server. (De server weet dus in principe niet welke gebruikers er zijn of welke branches ze hebben!)

We hebben twee hoofdbranches: <code>master</code> en <code>develop</code>. De livesite zou gelijk moeten lopen met de branch <code>master</code>, dus we moeten goed opletten wat we daarop zetten. Om makkelijk code te kunnen delen, gaan we in principe alle commits doen op de branch <code>develop</code>, maar het is nog netter om met branches te werken.

Handige commando's om het overzicht te bewaren:

* <code>git log</code> om de commits op je huidige branch te bekijken.
* <code>git log $commit-of-branch-of-etc</code> om de commits op een andere branch te bekijken. (Het is handig om hiervoor ook <code>git fetch</code> te doen.)
* <code>gitk</code> als je beter tegen een grafische interface kan.
* <code>git status</code> toont je branch, hoe die verschilt met origin/$branch en wat je ten opzichte van je branch hebt aangepast
* <code>git branch -a</code> toont elke branch waar git in jouw debug van afweet
* <code>git log --graph --decorate --pretty=oneline --abbrev-commit</code> om in de terminal een mooie gerichte graaf van commits te tonen (<code>--all</code> voor alle branches tegelijk)

=== Maak een feature ===

# <code>git checkout develop</code> en <code>git pull</code> om up to date te zijn
# maak een nieuwe branch met <code>git checkout -b feature-$bla</code>
# ga een stukje zitten programmeren
# heb je nieuwe bestanden toegevoegd: vertel dat aan git met <code>git add $bestand</code>
# wil je bestanden weggooien: doe dat en vertel het tegelijk aan git met <code>git rm $bestand</code>
# wil je kijken wat je allemaal hebt gedaan: gebruik <code>git status</code> en/of <code>git diff</code>
# ben je tevreden met een setje wijzigingen: commit ze met <code>git add $gewijzigd_bestand1 $gewijzigd_bestand2 ...</code> en <code>git commit</code> (het is netjes om eerst nog even te kijken wat je gaat committen zodat er geen troep meekomt)
# herhaal bovenstaande stappen tot je feature helemaal af is
# ben je klaar: stop je feature in develop met <code>git checkout develop</code> en dan <code>git merge feature-$bla</code> en maak het openbaar met <code>git push</code> '''(TODO: Of gaan we helemaal hardcore met pull requests beginnen?)'''
# alle webcie'ers krijgen nu een mailtje met de commits die je hebt gepleegd en zullen je feliciteren en/of afkraken op je programmeerstijl

Nu is werken in je eentje heel leuk, maar samenwerken geeft een veel mooier feestje! Daarom is het aan te raden dat je om de zoveel tijd commits van anderen opvraagt en met ze deelt:

# als iemand anders op je branch heeft gewerkt: doe <code>git pull</code> (krijg je een error in de trant van "geen remote voor branch", doe dan <code>git branch --set-upstream-to origin/feature-$bla</code> om de remote in te stellen en probeer opnieuw)
# als er dingen binnenkomen op develop: stop ze in je branch <code>git fetch</code>'en en dan <code>git merge origin/develop</code>. (Voor echte pro's is er ook <code>git rebase</code>, maar dat heeft meer problemen met samenwerken op de branch)
# als je je vooruitgang wilt delen: doe <code>git push</code> (krijg je een error in de trant van "geen remote voor branch", doe dan <code>git branch --set-upstream-to origin/feature-$bla</code> om de remote in te stellen en probeer opnieuw)

=== Fix een bug ===

(Je kan dit proces ook op develop doen als de bug niet zo heel hoge prioriteit heeft. Doe dan gewoon wat hierboven staat.)

Is er een bug die snel opgelost moet worden? Dan gaan we op basis van de livesite werken zodat we de fix apart kunnen houden van eventuele (halfbakken) features.

# <code>git checkout master</code> en <code>git pull</code> om up to date te zijn
# maak een nieuwe branch met <code>git checkout -b bug-$bla</code>
# doe precies hetzelfde programmeer-commitriedeltje als hiervoor beschreven
# als je in een commit een regel "Closes: #$bugnummer" zet, wordt de bug automatisch op gesloten gezet in Bugweb.
# ben je klaar: stop je fix in master met <code>git checkout master</code> en dan <code>git merge bug-$bla</code> en maak het openbaar met <code>git push</code>
# zorg ervoor dat develop up-to-date blijft: <code>git checkout develop</code> en dan <code>git merge master</code> en maak het openbaar met <code>git push</code>

=== Shit's on fire yo ===

Heb je er een potje van gemaakt, en wil je terug naar de laatste commit? Als je een enkel bestand wil terugzetten, heb je <code>git checkout $bestand</code>; alles wat je in het bestand hebt gedaan sinds de laatste commit wordt dan teruggezet zoals het was. De makkelijkste manier om echt helemaal alles weg te gooien is met <code>git reset --hard HEAD</code>; elk bestand dat je hebt veranderd t.o.v. je laatste commit wordt dan teruggezet zoals het was. Dit kan dus ook nuttige wijzigingen weggooien!

Heb je er een nog erger potje van gemaakt, en heb je een foute commit gemaakt? Als dit de laatste commit(s) was (waren) op je branch en je hebt ze nog niet gepusht, dan heb je <code>git reset HEAD~1</code> om de laatste commit weg te gooien (en <code>HEAD~</code>''n'' om ''n'' commits tegelijk ongedaan te maken.) Heb je ze al wel gepusht, dan moet je naar de aanpak hieronder overgaan.

Heeft iemand anders een enorm potje gemaakt, en wil je de commit ongedaan maken? Doe dan <code>git revert $commit</code>. Dat maakt een nieuwe commit waarin precies het tegenovergestelde gebeurt van die wijzigingen. De originele commit blijft nog wel in de geschiedenis staan! Als iemand dus geheime data heeft gecommit, moet je toch echt [https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History geavanceerde tools gebruiken].

== Om iets live te zetten ==

Ten eerste: denk goed na of je dit echt wel wilt doen. Er kunnen nog wel eens gebruikers gaan klagen.

Doe gewoon een <code>git push</code> naar master op je eigen bakkie. Typ lekker <code>./zetLive.sh</code> in de /scripts map en gaan met die banaan.

== Migreren van SVN naar Git ==

Is jouw debug van voor de overstap? Dan is het niet heel lastig om te switchen!

=== Verhuizen van git-svn ===
Gebruik je al Git-SVN, dan kun je als volgt switchen:
# <code>cd wwwdebug</code>
# <code>git remote add origin ssh://vm-www/srv/git</code>
# <code>git fetch</code>
# <code>git branch -t origin/develop</code>

Nu '''moet''' je handmatig commits van je huidige branches op develop rebasen, want anders gaat de hele geschiedenis stuk. Check dat de 3e commit vanaf het begin begint met <code>9cf65047</code> ipv <code>cc9c5bb</code>. Zo niet, ga je allemaal antieke ledendata meepushen (die ik met pijn en moeite heb weggefilterd) en gaat de Autoriteit Persoonsgegevens je slaan.

=== Verhuizen zonder git-svn ===
Heb je wel een wwwdebug maar nog geen git? Dan moet je iets meer moeite doen om je laatste versie te bewaren:
# <code>cd wwwdebug</code>
# <code>svn up</code>
# <code>svn log</code> Kijk hier wat de laatste revisie is!
# <code>git init</code>
# <code>git remote add origin ssh://vm-www/srv/git</code>
# <code>git fetch</code>
# <code>git commit --allow-empty -m "Initial empty commit"</code> (want git snapt het niet als je geen commit hebt gedaan en wel branches wil beginnen, dan maar zo)
# <code>git log origin/master</code> Kijk hier welke git-commit overeenkomt met de laatste svn-revisie.
# <code>git reset --mixed $laatste_revisie_commit</code>
# <code>git stash</code>
# <code>git checkout -t origin/develop</code>
# <code>git stash apply</code>

=== Vertaalsleutel svn -> git ===

Het belangrijkste verschil is dat git heel veel verschillende commitgeschiedenissen heeft en svn maar eentje. Bij elk commando vraagt svn bijvoorbeeld aan de server of er nog commits bijgekomen zijn. Git doet dat alleen als je erom vraagt met <code>git fetch</code>. Het is daarom een goed idee om als svn'er voor elk commando <code>git fetch</code> te runnen totdat je doorhebt wanneer het echt nuttig is.

* <code>svn up</code> -> <code>git pull</code> (vraag aan de remotes welke veranderingen er zijn, merge die automatisch)
* <code>svn st</code> -> <code>git status</code> (vraag de huidige status op van jouw lokale kopie ten opzichte van jouw laatste commit)
* <code>svn diff</code> -> <code>git diff</code> (bekijk alle wijzigingen die er zijn tussen jouw lokale kopie en jouw laatste commit)
* <code>svn ci</code> -> <code>git commit -a</code> (stop al je wijzigingen in een nieuwe commit, die je zou kunnen opsturen naar de andere WebCie'ers)

== Een nieuwe git-repo opzetten ==

Als je code die niet bij de livesite hoort wilt delen met de WebCie, kan dit via een aparte git-repo. Op deze manier maak je een nieuwe repo:

* <code>ssh vm-www</code>
* <code>cd /srv</code>
* <code>sudo mkdir git-$bla-repo</code>
* <code>sudo chown webcie:webcie /srv/git-$bla-repo</code>
* <code>sudo chmod o= /srv/git-$bla-repo</code>
* <code>sudo chmod ug=rwx /srv/git-$bla-repo</code>
* <code>sudo chmod g+s /srv/git-$bla-repo</code>
* <code>cd /srv/git-$bla-repo</code>
* <code>git init --bare --shared</code>

Nu kun je als het goed is een <code>git clone ssh://vm-www/srv/git-$bla-repo</code> doen!



[[Category:WebCie]]

Git (WebCie)

2017-06-01T20:13:25Z

Ludop:

Git (wat staat voor "Git") is het bovennatuurlijke systeem waarmee we controle houden op wat er gebeurt met alle WebCie-code. Als WebCie-lid heb je een kopie (een ''checkout'') van het volledige systeem staan op je eigen account (in de map <code>~/wwwdebug</code>). Deze code bepaalt wat jij te zien krijgt in je browser als je naar je persoonlijke debugpagina gaat (lijkt op <code>https://bla-debug.a-eskwadraat.nl</code>). Als je wijzigingen in deze code aanbrengt, veranderen dus alleen de pagina's op jouw persoonlijke debug-omgeving. Dat noemen we een sandbox, het zorgt er voor dat je rustig je code kan ontwikkelen zonder dat de rest van de WWW daar last van heeft. Bovendien is jouw debugpagina alleen benaderbaar door WebCie-leden, dus als je per ongeluk lekkende SQL-queries schrijft is dat geen ramp.

Op deze pagina staat basale info om aan de slag te gaan met Git. Je kan ook in de [https://git-scm.com/book/en/v2 online handleiding] kijken voor meer pro-tips.

De WebCie is onlangs  overgestapt naar Git. Hierbij is ook de svn-geschiedenis gefilterd, dus pas op bij overstappen!

== Workflow ==

Een ding waar je bij git waarschijnlijk aan moet wennen is dat iedereen een eigen idee heeft van de geschiedenis van alle code. Op de server staan een setje commitgeschiedenissen (oftewel branches), en op je debug staat ook zo'n setje. Met een beetje geluk komen ze ook nog overeen, maar dat hoeft dus niet! Er zijn commando's om van iemand anders de geschiedenis overnemen. Dan krijg je een kopietje binnen van hun geschiedenis, maar wordt jouw geschiedenis ''niet'' aangepast! Je hebt bijvoorbeeld de volgende branches, allemaal opgeslagen in je eigen debug:

* master (jouw laatste editie van de livesite)
* develop (jouw eigen editie van de "echte" code)
* feature-watleuks (jouw eigen editie van deze feature)
* feature-zoveel (een feature waarvan de server nog helemaal niet weet dat die bestaat)
* HEAD (wijst naar de laatste commit die bij jou is gebeurd, dus als het goed is de branch waar je nu op werkt)
* origin/master (wat jij denkt dat de servereditie van de livesite is)
* origin/develop (wat jij denkt dat de servereditie van de "echte" code is)
* origin/feature-watleuks (wat jij denkt dat de servereditie van de deze feature is)

Als je <code>git fetch</code> doet, zal git de laatste versie van elke branch van de server opvragen en die bewaren in origin/$branch. Dan kun je die weer in jouw branches stoppen met bijvoorbeeld <code>git merge</code>. Het commando <code>git pull</code> stuurt jouw editie van de huidige branch naar de server. (De server weet dus in principe niet welke gebruikers er zijn of welke branches ze hebben!)

We hebben twee hoofdbranches: <code>master</code> en <code>develop</code>. De livesite zou gelijk moeten lopen met de branch <code>master</code>, dus we moeten goed opletten wat we daarop zetten. Om makkelijk code te kunnen delen, gaan we in principe alle commits doen op de branch <code>develop</code>, maar het is nog netter om met branches te werken.

Handige commando's om het overzicht te bewaren:

* <code>git log</code> om de commits op je huidige branch te bekijken.
* <code>git log $commit-of-branch-of-etc</code> om de commits op een andere branch te bekijken. (Het is handig om hiervoor ook <code>git fetch</code> te doen.)
* <code>gitk</code> als je beter tegen een grafische interface kan.
* <code>git status</code> toont je branch, hoe die verschilt met origin/$branch en wat je ten opzichte van je branch hebt aangepast
* <code>git branch -a</code> toont elke branch waar git in jouw debug van afweet
* <code>git log --graph --decorate --pretty=oneline --abbrev-commit</code> om in de terminal een mooie gerichte graaf van commits te tonen (<code>--all</code> voor alle branches tegelijk)

=== Maak een feature ===

# <code>git checkout develop</code> en <code>git pull</code> om up to date te zijn
# maak een nieuwe branch met <code>git checkout -b feature-$bla</code>
# ga een stukje zitten programmeren
# heb je nieuwe bestanden toegevoegd: vertel dat aan git met <code>git add $bestand</code>
# wil je bestanden weggooien: doe dat en vertel het tegelijk aan git met <code>git rm $bestand</code>
# wil je kijken wat je allemaal hebt gedaan: gebruik <code>git status</code> en/of <code>git diff</code>
# ben je tevreden met een setje wijzigingen: commit ze met <code>git add $gewijzigd_bestand1 $gewijzigd_bestand2 ...</code> en <code>git commit</code> (het is netjes om eerst nog even te kijken wat je gaat committen zodat er geen troep meekomt)
# herhaal bovenstaande stappen tot je feature helemaal af is
# ben je klaar: stop je feature in develop met <code>git checkout develop</code> en dan <code>git merge feature-$bla</code> en maak het openbaar met <code>git push</code> '''(TODO: Of gaan we helemaal hardcore met pull requests beginnen?)'''
# alle webcie'ers krijgen nu een mailtje met de commits die je hebt gepleegd en zullen je feliciteren en/of afkraken op je programmeerstijl

Nu is werken in je eentje heel leuk, maar samenwerken geeft een veel mooier feestje! Daarom is het aan te raden dat je om de zoveel tijd commits van anderen opvraagt en met ze deelt:

# als iemand anders op je branch heeft gewerkt: doe <code>git pull</code> (krijg je een error in de trant van "geen remote voor branch", doe dan <code>git branch --set-upstream-to origin/feature-$bla</code> om de remote in te stellen en probeer opnieuw)
# als er dingen binnenkomen op develop: stop ze in je branch <code>git fetch</code>'en en dan <code>git merge origin/develop</code>. (Voor echte pro's is er ook <code>git rebase</code>, maar dat heeft meer problemen met samenwerken op de branch)
# als je je vooruitgang wilt delen: doe <code>git push</code> (krijg je een error in de trant van "geen remote voor branch", doe dan <code>git branch --set-upstream-to origin/feature-$bla</code> om de remote in te stellen en probeer opnieuw)

=== Fix een bug ===

(Je kan dit proces ook op develop doen als de bug niet zo heel hoge prioriteit heeft. Doe dan gewoon wat hierboven staat.)

Is er een bug die snel opgelost moet worden? Dan gaan we op basis van de livesite werken zodat we de fix apart kunnen houden van eventuele (halfbakken) features.

# <code>git checkout master</code> en <code>git pull</code> om up to date te zijn
# maak een nieuwe branch met <code>git checkout -b bug-$bla</code>
# doe precies hetzelfde programmeer-commitriedeltje als hiervoor beschreven
# als je in een commit een regel "Closes: #$bugnummer" zet, wordt de bug automatisch op gesloten gezet in Bugweb.
# ben je klaar: stop je fix in master met <code>git checkout master</code> en dan <code>git merge bug-$bla</code> en maak het openbaar met <code>git push</code>
# zorg ervoor dat develop up-to-date blijft: <code>git checkout develop</code> en dan <code>git merge master</code> en maak het openbaar met <code>git push</code>

=== Shit's on fire yo ===

Heb je er een potje van gemaakt, en wil je terug naar de laatste commit? Als je een enkel bestand wil terugzetten, heb je <code>git checkout $bestand</code>; alles wat je in het bestand hebt gedaan sinds de laatste commit wordt dan teruggezet zoals het was. De makkelijkste manier om echt helemaal alles weg te gooien is met <code>git reset --hard HEAD</code>; elk bestand dat je hebt veranderd t.o.v. je laatste commit wordt dan teruggezet zoals het was. Dit kan dus ook nuttige wijzigingen weggooien!

Heb je er een nog erger potje van gemaakt, en heb je een foute commit gemaakt? Als dit de laatste commit(s) was (waren) op je branch en je hebt ze nog niet gepusht, dan heb je <code>git reset HEAD~1</code> om de laatste commit weg te gooien (en <code>HEAD~</code>''n'' om ''n'' commits tegelijk ongedaan te maken.) Heb je ze al wel gepusht, dan moet je naar de aanpak hieronder overgaan.

Heeft iemand anders een enorm potje gemaakt, en wil je de commit ongedaan maken? Doe dan <code>git revert $commit</code>. Dat maakt een nieuwe commit waarin precies het tegenovergestelde gebeurt van die wijzigingen. De originele commit blijft nog wel in de geschiedenis staan! Als iemand dus geheime data heeft gecommit, moet je toch echt [https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History geavanceerde tools gebruiken].

== Om iets live te zetten ==

Ten eerste: denk goed na of je dit echt wel wilt doen. Er kunnen nog wel eens gebruikers gaan klagen.

Ga naar de live vm met <code>ssh vm-www</code> en log in als WebCie met <code>s webcie</code>. Er staat een git-repository in <code>/srv/http/www/git</code>, en je kunt gewoon een <code>git pull</code> doen om de live site up-to-date te maken met de git server.

-------------------------------------
Dit is echt flink oud nu. Doe gewoon een <code>git push</code> naar master op je eigen bakkie. Typ lekker <code>./zetLive.sh</code> in de /scripts map en gaan met die banaan.

== Migreren van SVN naar Git ==

Is jouw debug van voor de overstap? Dan is het niet heel lastig om te switchen!

=== Verhuizen van git-svn ===
Gebruik je al Git-SVN, dan kun je als volgt switchen:
# <code>cd wwwdebug</code>
# <code>git remote add origin ssh://vm-www/srv/git</code>
# <code>git fetch</code>
# <code>git branch -t origin/develop</code>

Nu '''moet''' je handmatig commits van je huidige branches op develop rebasen, want anders gaat de hele geschiedenis stuk. Check dat de 3e commit vanaf het begin begint met <code>9cf65047</code> ipv <code>cc9c5bb</code>. Zo niet, ga je allemaal antieke ledendata meepushen (die ik met pijn en moeite heb weggefilterd) en gaat de Autoriteit Persoonsgegevens je slaan.

=== Verhuizen zonder git-svn ===
Heb je wel een wwwdebug maar nog geen git? Dan moet je iets meer moeite doen om je laatste versie te bewaren:
# <code>cd wwwdebug</code>
# <code>svn up</code>
# <code>svn log</code> Kijk hier wat de laatste revisie is!
# <code>git init</code>
# <code>git remote add origin ssh://vm-www/srv/git</code>
# <code>git fetch</code>
# <code>git commit --allow-empty -m "Initial empty commit"</code> (want git snapt het niet als je geen commit hebt gedaan en wel branches wil beginnen, dan maar zo)
# <code>git log origin/master</code> Kijk hier welke git-commit overeenkomt met de laatste svn-revisie.
# <code>git reset --mixed $laatste_revisie_commit</code>
# <code>git stash</code>
# <code>git checkout -t origin/develop</code>
# <code>git stash apply</code>

=== Vertaalsleutel svn -> git ===

Het belangrijkste verschil is dat git heel veel verschillende commitgeschiedenissen heeft en svn maar eentje. Bij elk commando vraagt svn bijvoorbeeld aan de server of er nog commits bijgekomen zijn. Git doet dat alleen als je erom vraagt met <code>git fetch</code>. Het is daarom een goed idee om als svn'er voor elk commando <code>git fetch</code> te runnen totdat je doorhebt wanneer het echt nuttig is.

* <code>svn up</code> -> <code>git pull</code> (vraag aan de remotes welke veranderingen er zijn, merge die automatisch)
* <code>svn st</code> -> <code>git status</code> (vraag de huidige status op van jouw lokale kopie ten opzichte van jouw laatste commit)
* <code>svn diff</code> -> <code>git diff</code> (bekijk alle wijzigingen die er zijn tussen jouw lokale kopie en jouw laatste commit)
* <code>svn ci</code> -> <code>git commit -a</code> (stop al je wijzigingen in een nieuwe commit, die je zou kunnen opsturen naar de andere WebCie'ers)

== Een nieuwe git-repo opzetten ==

Als je code die niet bij de livesite hoort wilt delen met de WebCie, kan dit via een aparte git-repo. Op deze manier maak je een nieuwe repo:

* <code>ssh vm-www</code>
* <code>cd /srv</code>
* <code>sudo mkdir git-$bla-repo</code>
* <code>sudo chown webcie:webcie /srv/git-$bla-repo</code>
* <code>sudo chmod o= /srv/git-$bla-repo</code>
* <code>sudo chmod ug=rwx /srv/git-$bla-repo</code>
* <code>sudo chmod g+s /srv/git-$bla-repo</code>
* <code>cd /srv/git-$bla-repo</code>
* <code>git init --bare --shared</code>

Nu kun je als het goed is een <code>git clone ssh://vm-www/srv/git-$bla-repo</code> doen!



[[Category:WebCie]]

Bestuurswissel

2017-05-05T19:24:01Z

Ludop: spelfoutje en <code> om code heen

[[Category:WebCie]]
Stappenplan voor een bestuurswissel, waarschijnlijk ook wsw4 compatible.

=== Website frontside TODO ===

#Maak een nieuwe commissie aan met login bestuurjjjj
#Voeg alle mensen die daar in horen toe aan het bestuur.
#Maak een publisher pagina aan voor het huidige bestuur ("bestuurjjjj").
#Pas de redirects in benamite (/Vereniging/Bestuur en /Vereniging/Commissies/Bestuur) aan zodat ze naar de nieuwe bestuurscommissie wijzen
#Dubbelcheck even of alles nog werkt.

===Backside TODO===
#Check of onderstaande dingen al meteen moeten worden aangepast, het kan best zijn dat een (oud)bestuurslid nog tijdelijk bestuursrechten nodig heeft voor de laatste inwerking of afronding van werkzaamheden.
#Pas specialconstants.php in /space/ aan:
#:*naam van de boekcom
#:*naam van de comint (wordt secretaris en comond?)
#Pas init.php in /space/auth aan:
#:*pas de <code>$BOEKCOMNRS[]=%LIDNR%</code> aan voor de boekcom en vice.
#:*pas de <code>$BESTUURLIDNRS[]=%LIDNR%</code> aan voor de nieuwe bestuursleden en haal de oude weg.

QueryBuilder

2017-04-13T21:34:55Z

Ludop: /* whereProp varianten */

Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.

De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.

== QueryBuilder starten ==
Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.
Een voorbeeld:
<syntaxhighlight lang="php" line='line'>
$query = PersoonQuery::table();
</syntaxhighlight>

== Query uitvoeren ==
Een query kan je uitvoeren met de methode <code>get</code>. <code>get</code> heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:
<syntaxhighlight lang="php" line='line'>
$personen = PersoonQuery::table()->get();
</syntaxhighlight>

=== <code>first</code> ===
De methode <code>first</code> voert de query uit zoals <code>get</code> dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:
<syntaxhighlight lang="php" line='line'>
$personen = PersoonQuery::table()->first();
</syntaxhighlight>

=== <code>aggregate</code> (TODO: in de php-code moet deze functie nog worden aangepast) ===
De methode <code>aggregate</code> voert een aggregator uit op de query. De toegestane aggregators zijn: <code>COUNT</code>, <code>SUM</code>, <code>MAX</code>, <code>MIN</code> en <code>YEAR</code>. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. <code>aggregate</code> haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:
<syntaxhighlight lang="php" line='line'>
$aantal_personen = PersoonQuery::table()->aggregate('COUNT');
</syntaxhighlight>

=== <code>count</code> ===
Om makkelijker entries te tellen is de speciale methode <code>count</code>. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.
<syntaxhighlight lang="php" line='line'>
$aantal_personen = PersoonQuery::table()->count();
</syntaxhighlight>

=== <code>verzamel</code> ===
De methode die het vaakst gebruikt wordt is <code>verzamel</code>. Net zoals <code>verzamel</code> van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:
<syntaxhighlight lang="php" line='line'>
$persoon_objecten = PersoonQuery::table()->verzamel();
</syntaxhighlight>
Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook <code>join</code>):
<syntaxhighlight lang="php" line='line'>
$persoon_objecten = BugQuery::table()
->join('Persoon')
->verzamel('Persoon', true);
</syntaxhighlight>

=== <code>geef</code> ===
Net zoals de methode <code>geef</code> voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij <code>verzamel</code> heeft de methode een argument voor het soort object wat je op wilt halen.
Geef het lid-object met ID 5794
<syntaxhighlight lang="php" line='line'>
$persoon = PersoonQuery::table()
->whereInt('contactID', 5794)
->geef();
</syntaxhighlight>

== Joins ==
De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.

=== (left) <code>join</code> ===
De standaard <code>join</code> is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug
<syntaxhighlight lang="php" line='line'>
$query = BugQuery::table()->join('Persoon');
</syntaxhighlight>
Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden
<syntaxhighlight lang="php" line='line'>
$query = BugQuery::table()->join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');
</syntaxhighlight>

Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen
<syntaxhighlight lang="php" line='line'>
$query = BugQuery::table()->join(array('p' => 'Persoon'));
</syntaxhighlight>

=== <code>rightJoin</code> ===
De <code>rightJoin</code> werkt hetzelfde als <code>join</code> alleen voert het een right join uit ipv een left join.
<syntaxhighlight lang="php" line='line'>
$query = BugQuery::table()->rightJoin('Persoon');
</syntaxhighlight>

=== <code>innerJoin</code> ===
De <code>innerJoin</code> werkt ook hetzelfde als <code>join</code> alleen voert het een inner join uit ipv een left join.
<syntaxhighlight lang="php" line='line'>
$query = BugQuery::table()->innerJoin('Persoon');
</syntaxhighlight>

=== <code>fullJoin</code> ===
De <code>fullJoin</code> werkt ook hetzelfde als <code>join</code> alleen voert het een full join uit ipv een left join.
<syntaxhighlight lang="php" line='line'>
$query = BugQuery::table()->fullJoin('Persoon');
</syntaxhighlight>

== Where ==
Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.

=== <code>whereProp</code> ===
De belangrijkste where-methode is <code>whereProp</code>. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.

Je kan <code>whereProp</code> twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.
Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)
<syntaxhighlight lang="php" line='line'>
$bugs = BugQuery::table()->whereProp('melder', $melder)->verzamel();
</syntaxhighlight>

Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn
Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)
<syntaxhighlight lang="php" line='line'>
$bugs = BugQuery::table()->whereProp('melder', '!=', $melder)->verzamel();
</syntaxhighlight>

=== <code>whereProp</code> varianten ===

Met de standaard <code>whereProp</code> kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden <code>whereNotProp</code>, <code>whereLikeProp</code>, <code>whereNotLikeProp</code>, <code>whereInProp</code> en <code>whereNotInProp</code>. Wat deze methoden doen zit in de naam van de methoden. Voor de <code>whereLikeProp</code> en <code>whereNotLikeProp</code> heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden <code>whereInProp</code> en <code>whereNotInProp</code> heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.
Haal alle bugs op waarbij het email de string 'pepijno' bevat
<syntaxhighlight lang="php" line='line'>
$bugs = BugQuery::table()->whereLikeProp('melderEmail', '%pepijno%')->verzamel();
</syntaxhighlight>

=== OR ipv AND ===

Als je meerdere <code>whereProp</code>-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode <code>orWhereProp</code>. Voor alle andere soorten <code>whereProp</code>-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.

=== Overige <code>where</code>-methoden ===

Als je een WHERE-clausule wilt gebruiken kan je ipv <code>whereProp</code> ook standaard <code>where</code>-methoden gebruiken. Deze gebruik je op dezelfde manier als <code>whereProp</code>-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je <code>whereInt</code> gebruiken.
Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)
<syntaxhighlight lang="php" line='line'>
$bugs = BugQuery::table()->whereInt('melder_contactID', 5794)->verzamel();
</syntaxhighlight>

Naast deze standaard <code>where</code>-methode heb je ook de self explainatory methoden <code>whereNot</code>, <code>whereIn</code>, <code>whereNotIn</code>, <code>whereLike</code>, <code>whereNotLike</code>, <code>whereNull</code> en <code>whereNotNull</code>. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij <code>orWhereProp</code>.

=== Nested where's & Closures ===

Stel, je wilt de volgende WHERE-clausule:
WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)
Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt
<syntaxhighlight lang="php" line='line'>
...->where(function($q) use ($var1, $var2) {
$q->whereInt('a', 0)
->orWhereInt('a', 1);
})->where(function($q) {
$q->whereInt('a', 2)
->orWhereInt('a', 3);
})
</syntaxhighlight>

In een where kan je dus een closure gebruiken om nested where's te krijgen.

== Selects ==

Om selects toe te voegen aan je query gebruik je de methode <code>select</code>. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.
Om alle contactID's te selecteren van de Persoontable
<syntaxhighlight lang="php" line='line'>
$ids = PersoonQuery::table()->select('contactID')->get();
</syntaxhighlight>
Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable
<syntaxhighlight lang="php" line='line'>
$ids = PersoonQuery::table()->select(array('ID' => 'contactID'), 'voornaam')->get();
</syntaxhighlight>
Om selects distinct te maken kan je de methode <code>selectDistinct</code> gebruiken.

== Order by ==

Order by's can de QueryBuilder ook aan. Er zijn twee methoden <code>orderByAsc</code> en <code>orderByDesc</code>. Allebei de methoden hebben slechts 1 argument nodig, de kolom om de order op uit te voeren.
Selecteer alle Personen geordered op contactID
<syntaxhighlight lang="php" line='line'>
$personen = PersoonQuery::table()->orderByAsc('contactID')->verzamel();
</syntaxhighlight>

== Limit & offset ==

Om de limit en offset van een query te bepalen zijn er de twee methoden <code>offset</code> en <code>limit</code>. Beide methoden hebben 1 argument nodig, de offset of limit respectivelijk.
Selecteer de personen 200 t/m 300
<syntaxhighlight lang="php" line='line'>
$personen = PersoonQuery::table()->limit(100)->offset(200)->verzamel();
</syntaxhighlight>

== Havings ==

Havings werken op dezelfde manier als alle where-methoden, zowel de standaard <code>having</code> als de standaard <code>havingProp</code>. De namen van de methoden zijn precies hetzelfde als de where-methoden, alleen is elke where vervangen door having.

[[Category:WebCie]]

Cron

2017-02-23T19:47:39Z

Ludop:

De cronjobs zijn alle scripts in <code>/scripts/cron</code> die om de <code>$x</code>-tijd uitgevoerd moeten worden.

De lijst van alle jobs die daadwerkelijk uitgevoerd worden staan in het <code>/scripts/cron/crontab_vm-www[|-debug].webcie</code> bestand.

= Formaat =
Schaamteloos uit /etc/crontab gekopieerd:

<pre>
For details see man 4 crontabs
Example of job definition:
.---------------- minute (0 - 59)
| .------------- hour (0 - 23)
| | .---------- day of month (1 - 31)
| | | .------- month (1 - 12) OR jan,feb,mar,apr ...
| | | | .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
| | | | |
* * * * * user-name command to be executed
</pre>

= Nieuwe cronjob =

Om een nieuwe cronjob toe te voegen of die crontab anderszins aan te passen, moet je op de juiste VM de crontab installeren:
<pre>
ssh vm-www[|-debug]
s webcie
cd /srv/http/www/scripts/cron
crontab -l # check dat je de goede crontab te pakken hebt
crontab /scripts/cron/crontab_vm-www[|-debug].webcie # installeer die hap
</pre>

Nu wordt de crontab van de huidige gebruiker geinstalleerd, en dat wil je!

[[Category:WebCie]]

Cron

2017-02-23T19:24:02Z

Ludop: Created page with "De cronjobs zijn alle scripts in <code>/scripts/cron</code> die om de <code>$x</code>-tijd uitgevoerd moeten worden. De lijst van alle jobs die daadwerkelijk uitgevoerd worde..."