• http://michaelheap.com/installing-phpunit-under-php-5-4-from-homebrew/
• http://wp-cli.org/blog/plugin-unit-tests.html
• http://make.wordpress.org/core/handbook/automated-testing/
• http://codex.buddypress.org/developer/automated-testing/
• https://github.com/wp-cli/sample-plugin
• https://travis-ci.org/

svn co https://unit-tests.svn.wordpress.org/trunk wordpress-tests

export WP_TESTS_DIR="/Users/remco/wp/wordpress-tests"

?>

Hierdoor kunnen probleem ontstaan met bijvoorbeeld de XML-RPC-server of XML-sitemaps binnen WordPress. Binnen Eclipse kan gelukkig eenvoudig gezocht worden met behulp van reguliere expressies. Met behulp van de volgende zoekopdracht kan ik dergelijke problemen eenvoudig opspeuren binnen een Eclipse-project:

\?>\s\z

De \s zal overeenkomen met white space en de \z met het einde van het bestand.

We adviseren zelf altijd om PHP niet af te sluiten met een ?> PHP-tag, dit levert vaak meer problemen op dan dat je er profijt van hebt.

“Schrijf code wat eenvoudig is te vervangen, niet wat eenvoudig is uit te breiden.”

http://youtu.be/csyL9EC0S0c?t=41m8s

Vicent heeft een eenvoudige en logische manier van vertakken binnen Git in kaart gebracht. Hieronder is een mooi overzicht te zien van hoe het vertakken in de praktijk gebruikt kan worden:

Mark Kelnar (@renderandserve) geeft in een presentatie tijdens WordCamp Atlanta 2012 een aantal WordPress optimalisatie tips. De presentatie is terug te vinden op de volgende pagina en zeker de moeite waard om eens door te lezen:

http://wpengine.com/optimizing-wordpress/

WPEngine heeft een zeer krachtige hosting omgeving voor WordPress neergezet. Volgens raheemm draaien de WPEngine diensten op de volgende configuratie:

• NGINX (reverse proxy)
• Apache (webserver)
• APC (PHP Accelerator)
• CDN ingebakken in de architectuur
• Ongelooflijk krachtige hardware

Ik denk dat veel Nederlandse WordPress hossting providers nog veel kunnen leren van de manier waarop WPEngine WordPress hosting aanbiedt.

Om de vertalingen zo efficiënt mogelijk op te zetten moeten er 2 .PO of .POT bestanden aangemaakt worden. Normaliter scande ik altijd met behulp van Poedit naar alle vertaalbare teksten binnen een plugin. Echter kan ik met Poedit niet onderscheid maken tussen vertalingen binnen de admin omgeving.

Er zijn meerdere gebruikers van Poedit die wel graag van een dergelijke functionaliteit gebruik willen maken. De ontwikkelaar van Poedit geeft echter in een ticket het volgende aan:

 The scanning feature of Poedit is intended for basic, simple uses. If you have more demanding needs, they you should write a proper makefile and call xgettext in it to create a POT file from your sources; then use Poedit just to translate PO catalogs and update them from that POT file.

At this time, I don’t want additional complications in this part of Poedit. Maybe later, when all the other, more serious, problems are fixed.

Ik ben me daarom gaan verdiepen in de werking van xgettext:

• http://www.gnu.org/software/gettext/manual/html_node/xgettext-Invocation.html
• http://www.lxg.de/code/playing-with-xgettext
• http://stackoverflow.com/questions/1864233/recusive-xgettext
• http://stackoverflow.com/questions/1352995/xgettext-vs-gettext
• http://stackoverflow.com/questions/11451105/recursive-scan-for-files-with-xgettext

Uiteindelijk heb ik de volgende twee commando’s geschreven waarmee we de WooCommerce vertalingen kunnen opdelen in verschillende bestanden.

WooCommerce admin

find ./admin -iname "*.php" -type f | xgettext \
--from-code=UTF-8 \
--keyword=__ \
--keyword=_e \
--keyword=_n:1,2 \
--keyword=_x:1,2c \
--keyword=_ex:1,2c \
--keyword=_nx:1,2,4c \
--default-domain=woocommerce \
--language=PHP \
--copyright-holder="Remco Tolsma" \
--package-name=WooCommerce \
--package-version=2.0.5 \
--msgid-bugs-address="Remco Tolsma <info@remcotolsma.nl>" \
--files-from=- \
--output=woocommerce-admin.pot

WooCommerce

find ./ -iname "*.php" -type f | xgettext \
--from-code=UTF-8 \
--keyword=__ \
--keyword=_e \
--keyword=_n:1,2 \
--keyword=_x:1,2c \
--keyword=_ex:1,2c \
--keyword=_nx:1,2,4c \
--default-domain=woocommerce \
--language=PHP \
--copyright-holder="Remco Tolsma" \
--package-name=WooCommerce \
--package-version=2.0.5 \
--msgid-bugs-address="Remco Tolsma <info@remcotolsma.nl>" \
--files-from=- \
--exclude-file=woocommerce-admin.pot \
--output=woocommerce.pot

Bovenstaande commando’s bestaan uit  2 delen, een ‘find’ commando waarmee alle PHP-bestanden binnen de plugin worden gevonden. En een ‘xgettext’ commando die alle vertalingen binnen deze bestanden op zoekt. Hier worden de WordPress vertaalfuncties als ‘keyword’ meegegeven.

• __()
• _e()
• _n()
• _x()
• _ex()
• _nx()

Mocht je overigens bij het uitvoeren van het tweede commando een “Segmentation” fout krijgen dan moet je misschien je gettext pakket updaten. Ik kreeg op mijn Mac deze fout met gettext versie 0.18.1. Na het updaten van gettext via MacPorts naar versie 0.18.2 was dit probleem opgelost:

sudo port selfupdate
sudo port upgrade outdated

Vervolgens hebben we de gegenereerde .POT-bestanden toegevoegd aan onze GlotPress installatie.

Waar in WooCommerce 1.6.6 nog 2058 teksten in één bestand stonden en altijd geladen werden is dit met deze wijziging bijna gehalveerd. Deze verbetering hebben we ook verwerkt in de “WooCommerce (nl)” plugin. Met behulp van een Makefile kunnen we eenvoudig de 2 .POT-bestanden aanmaken:

WOOCOMMERCE_DIR=../woocommerce/

# Make POT files
extract:
	cd $(WOOCOMMERCE_DIR) && \
	find ./admin -iname "*.php" -type f | xgettext \
	--from-code=UTF-8 \
	--keyword=__ \
	--keyword=_e \
	--keyword=_n:1,2 \
	--keyword=_x:1,2c \
	--keyword=_ex:1,2c \
	--keyword=_nx:1,2,4c \
	--default-domain=woocommerce \
	--language=PHP \
	--copyright-holder="Remco Tolsma" \
	--package-name=WooCommerce \
	--package-version=2.0.5 \
	--msgid-bugs-address="Remco Tolsma <info@remcotolsma.nl>" \
	--files-from=- \
	--output=$(CURDIR)/languages/woocommerce/woocommerce-admin.pot \

	cd $(WOOCOMMERCE_DIR) && \
	find ./ -iname "*.php" -type f | xgettext \
	--from-code=UTF-8 \
	--keyword=__ \
	--keyword=_e \
	--keyword=_n:1,2 \
	--keyword=_x:1,2c \
	--keyword=_ex:1,2c \
	--keyword=_nx:1,2,4c \
	--default-domain=woocommerce \
	--language=PHP \
	--copyright-holder="Remco Tolsma" \
	--package-name=WooCommerce \
	--package-version=2.0.5 \
	--msgid-bugs-address="Remco Tolsma <info@remcotolsma.nl>" \
	--files-from=- \
	--exclude-file=$(CURDIR)/languages/woocommerce/woocommerce-admin.pot \
	--output=$(CURDIR)/languages/woocommerce/woocommerce.pot

We liepen echter tegen problemen dat de wp_is_mobile() functie check niet overeenkwam met de standaard W3 Total Cache “User Agent Groups”. Hierdoor werd soms op desktop browsers toch de mobiele versie van de website weergegeven. Daarom zijn we opzoek gegaan naar een manier om de W3 Total Cache check te gebruiken.

Na het doorzoeken van de W3 Total Cache code kwamen uit op de volgende classes en functies:

• http://plugins.trac.wordpress.org/browser/w3-total-cache/tags/0.9.2.8/lib/W3/Mobile.php
• http://plugins.trac.wordpress.org/browser/w3-total-cache/tags/0.9.2.8/lib/W3/CacheCase.php#L26

Aan de hand hiervan hebben we de volgende help functie kunnen schrijven:

if ( ! function_exists( 'is_mobile' ) ) { 
	function is_mobile() {
		$is_mobile = false;

		if ( class_exists( 'W3_Mobile' ) ) {
			$w3_mobile = new W3_Mobile();

			$group = $w3_mobile->get_group();

			$is_mobile = $group !== false;
		}

		return $is_mobile;
	}
}

Met behulp van de volgende code kunnen alle WooCommerce teksten eenvoudig aangepast worden.

/**
 * Translate WooCommerce text
 *
 * @link http://codex.wordpress.org/Plugin_API/Filter_Reference/gettext
 */
function prefix_translate_woocommerce( $translated_text, $text, $domain ) {
	if ( $domain == 'woocommerce' ) {
		switch ( $text ) {
			case 'Checkout →' :
				$translated_text = 'Bestellen';
				break;
			case 'Add to Cart' :
			case 'Add to cart' :
				$translated_text = 'Bestellen';
				break;
		}
	}

	return $translated_text;
}

add_filter( 'gettext', 'prefix_translate_woocommerce', 20, 3 );

We maken bij Pronamic echter geen gebruik van Word, maar van OpenOffice en/of LibreOffice. Als we de sjablonen met deze programma’s wijzigden dan ontstonden er helaas problemen. Hierdoor konden we bij Pronamic de Twinfield factuur sjablonen helaas niet wijzigen.

In de Twinfield Knowledge Base staan verschillende voorbeelden van hoe een factuur sjabloon er uit moet zien:

• Hoe maak ik een Word-factuur, een aanmaning of een betaalspecificatie?
• How do I create a Word-invoice, a dunning or a payment specification?

Nederlandse sjablonen

Engelse sjablonen

In het uitleg document van Twinfield wordt aangegeven dat de volgende samenvoeg velden beschikbaar zijn:

HeaderStart
HeaderEnd
FooterStart
FooterEnd
addressinv_name
addressinv_addr1
addressinv_addr2
addressinv_addr3
addressinv_postcode
addressinv_city
addressinv_country_@code
addressinv_country
addressinv_addr4
addressinv_addr5
addressdel_name
addressdel_addr1
addressdel_addr2
addressdel_addr3
addressdel_postcode
addressdel_city
addressdel_country_@code
addressdel_country
addressdel_addr4
addressdel_addr5
header_invdate
header_duedate
header_perfdate
header_invnum
header_vatnumber
header_customer
header_customername
header_period
header_headerdescr
header_footerdescr
header_printstatus
header_paycode
bank_name
bank_account
header_print
header_printcount
header_usrcode_@name
header_authoriser_@name
TableStart:lines
TableEnd:lines
lines_line_@id
header_currency
lines_line_artcode
lines_line_subcode
lines_line_name
lines_line_sname
lines_line_extref1
lines_line_extref2
lines_line_extref3
lines_line_dim2
lines_line_dim2_@name
lines_line_dim3
lines_line_dim3_@name
lines_line_dim4
lines_line_dim4_@name
lines_line_fincode
lines_line_finnumber
lines_line_acpay_@name
lines_line_perfdate
lines_line_qty
lines_line_descr
lines_line_unitsprice_@regional
lines_line_unitspriceinc_@regional
lines_line_currency
lines_line_taxrate
lines_line_taxvalue_@regional
lines_line_invvalue_@regional
lines_line_invvalueinc_@regional
TableStart:taxlines
TableEnd:taxlines
calclines_taxline_currency
calclines_taxline_taxname
calclines_taxline_perftype
calclines_taxline_perfyearmonth
calclines_taxline_taxover_@regional
calclines_taxline_taxvalue_@regional
calclines_taxline_valueincl_@regional
calclines_totalline_valueexcl_@regional
calclines_totalline_taxvalue_@regional
calclines_totalline_value_@regional
lines_line_teq_week
lines_line_teq_month
lines_line_teq_quarter
lines_line_dim1
lines_line_dim1_@name
lines_line_dim1_@sname
lines_line_dim1_@prjinvdescr
lines_line_dim2_@sname
lines_line_dim2_@prjinvdescr
lines_line_transdate
TableStart:timelines
TableEnd:timelines
time_line_user_@name
time_line_user_@sname
time_line_user
time_line_transdate
time_line_project_@name
time_line_project_@sname
time_line_project_@prjinvdescr
time_line_project
time_line_activity_@name
time_line_activity_@sname
time_line_activity_@actinvdescr
time_line_activity
time_line_descr
time_line_qty
time_line_price
calclines_totalline_value_@predecimal
calclines_totalline_value_@postdecimal
header_customer_@account
customer_custname
customer_name
customer_addr1
customer_addr2
customer_addr3
customer_postcode
customer_city
customer_country
customer_country_@name
customer_modified
customer_dimcode
customer_basecurrency
customer_basecurrency_@name
customer_basecurrency_@shortname
customer_reportingcurrency
customer_reportingcurrency_@name
customer_reportingcurrency_@shortname
customer_invoicecurrency
customer_invoicecurrency_@name
customer_invoicecurrency_@shortname
customer_totalbasevalueopen
customer_totalrepvalueopen
customer_totalvalueopen
TableStart:customer
TableEnd:customer
customer_detail_invnumber
customer_detail_inpdate
customer_detail_basevalueopen
customer_detail_valueopen
customer_detail_repvalueopen
customer_detail_basevalue
customer_detail_value
customer_detail_repvalue
customer_detail_basevaluepaid
customer_detail_valuepaid
customer_detail_repvaluepaid
customer_detail_days
customer_detail_duedate
customer_detail_currency
customer_detail_currency_@name
customer_detail_currency_@shortname
customer_detail_description
customer_totalbasevalueopen_@predecimal
customer_totalrepvalueopen_@predecimal
customer_totalvalueopen_@predecimal
customer_totalbasevalueopen_@postdecimal
customer_totalrepvalueopen_@postdecimal
customer_totalvalueopen_@postdecimal
customer_account
name
addr1
addr2
addr3
addr4
addr5
postcode
city
country
dimcode
dimname
date
office_code
office_name
office_vatnumber
office_address_line1
office_address_line2
office_address_line3
office_address_line4
office_address_line5
office_address_line6
office_address_zipcode
office_address_city
office_address_country
office_address_telephone
office_address_fax
bank_code
bank_ascription
bank_iban
bank_accountnumber
bank_nationalbic
bank_bic
bank_address_line1
bank_address_line2
bank_address_line3
bank_address_line4
bank_address_line5
bank_address_line6
bank_address_zipcode
bank_address_city
bank_address_country
bank_address_telephone
bank_address_fax
TableStart:details
TableEnd:details
details_detail_invdate
details_detail_duedate
details_detail_invnumber
details_detail_origvalue
details_detail_value
details_detail_origbasevalue
details_detail_basevalue
details_detail_trscode_@name
details_detail_trsnumber
origvalue
value
currency
valuetext
TableStart:cheque_details
TableEnd:cheque_details
cheque_details_detail_invdate
cheque_details_detail_duedate
cheque_details_detail_invnumber
cheque_details_detail_origvalue
cheque_details_detail_value
cheque_details_detail_origbasevalue
cheque_details_detail_basevalue
cheque_details_detail_trscode_@name
cheque_details_detail_trsnumber
millions
hundreds_of_thousands
tens_of_thousands
thousands
hundreds
tens
units
cents

Helaas gaan deze Word samenvoeg velden verloren bij het opslaan van .doc bestanden in LibreOffice. Na veel uitzoekwerk bleek dit te komen doordat de samenvoeg velden niet gekoppeld zijn aan een database.

Binnen LibreOffice kan er net als in Microsoft Word gewerkt worden met samenvoeg velden. In het LibreOffice worden deze samenvoeg velden ook wel “Mail merge fields” genoemd.

Deze “Mail merge fields” kunnen echter niet vrij ingevoerd worden. In plaats daarvan moeten er kolommen uit een database tabel geselecteerd worden. Door een CSV bestand aan te maken met alle beschikbare Twinfield samenvoeg velden is dit echter eenvoudig te realiseren.

HeaderStart,HeaderEnd,FooterStart,FooterEnd,addressinv_name,addressinv_addr1,addressinv_addr2,addressinv_addr3,addressinv_postcode,addressinv_city,addressinv_country_@code,addressinv_country,addressinv_addr4,addressinv_addr5,addressdel_name,addressdel_addr1,addressdel_addr2,addressdel_addr3,addressdel_postcode,addressdel_city,addressdel_country_@code,addressdel_country,addressdel_addr4,addressdel_addr5,header_invdate,header_duedate,header_perfdate,header_invnum,header_vatnumber,header_customer,header_customername,header_period,header_headerdescr,header_footerdescr,header_printstatus,header_paycode,bank_name,bank_account,header_print,header_printcount,header_usrcode_@name,header_authoriser_@name,TableStart:lines,TableEnd:lines,lines_line_@id,header_currency,lines_line_artcode,lines_line_subcode,lines_line_name,lines_line_sname,lines_line_extref1,lines_line_extref2,lines_line_extref3,lines_line_dim2,lines_line_dim2_@name,lines_line_dim3,lines_line_dim3_@name,lines_line_dim4,lines_line_dim4_@name,lines_line_fincode,lines_line_finnumber,lines_line_acpay_@name,lines_line_perfdate,lines_line_qty,lines_line_descr,lines_line_unitsprice_@regional,lines_line_unitspriceinc_@regional,lines_line_currency,lines_line_taxrate,lines_line_taxvalue_@regional,lines_line_invvalue_@regional,lines_line_invvalueinc_@regional,TableStart:taxlines,TableEnd:taxlines,calclines_taxline_currency,calclines_taxline_taxname,calclines_taxline_perftype,calclines_taxline_perfyearmonth,calclines_taxline_taxover_@regional,calclines_taxline_taxvalue_@regional,calclines_taxline_valueincl_@regional,calclines_totalline_valueexcl_@regional,calclines_totalline_taxvalue_@regional,calclines_totalline_value_@regional,lines_line_teq_week,lines_line_teq_month,lines_line_teq_quarter,lines_line_dim1,lines_line_dim1_@name,lines_line_dim1_@sname,lines_line_dim1_@prjinvdescr,lines_line_dim2_@sname,lines_line_dim2_@prjinvdescr,lines_line_transdate,TableStart:timelines,TableEnd:timelines,time_line_user_@name,time_line_user_@sname,time_line_user,time_line_transdate,time_line_project_@name,time_line_project_@sname,time_line_project_@prjinvdescr,time_line_project,time_line_activity_@name,time_line_activity_@sname,time_line_activity_@actinvdescr,time_line_activity,time_line_descr,time_line_qty,time_line_price,calclines_totalline_value_@predecimal,calclines_totalline_value_@postdecimal,header_customer_@account,customer_custname,customer_name,customer_addr1,customer_addr2,customer_addr3,customer_postcode,customer_city,customer_country,customer_country_@name,customer_modified,customer_dimcode,customer_basecurrency,customer_basecurrency_@name,customer_basecurrency_@shortname,customer_reportingcurrency,customer_reportingcurrency_@name,customer_reportingcurrency_@shortname,customer_invoicecurrency,customer_invoicecurrency_@name,customer_invoicecurrency_@shortname,customer_totalbasevalueopen,customer_totalrepvalueopen,customer_totalvalueopen,TableStart:customer,TableEnd:customer,customer_detail_invnumber,customer_detail_inpdate,customer_detail_basevalueopen,customer_detail_valueopen,customer_detail_repvalueopen,customer_detail_basevalue,customer_detail_value,customer_detail_repvalue,customer_detail_basevaluepaid,customer_detail_valuepaid,customer_detail_repvaluepaid,customer_detail_days,customer_detail_duedate,customer_detail_currency,customer_detail_currency_@name,customer_detail_currency_@shortname,customer_detail_description,customer_totalbasevalueopen_@predecimal,customer_totalrepvalueopen_@predecimal,customer_totalvalueopen_@predecimal,customer_totalbasevalueopen_@postdecimal,customer_totalrepvalueopen_@postdecimal,customer_totalvalueopen_@postdecimal,customer_account,name,addr1,addr2,addr3,addr4,addr5,postcode,city,country,dimcode,dimname,date,office_code,office_name,office_vatnumber,office_address_line1,office_address_line2,office_address_line3,office_address_line4,office_address_line5,office_address_line6,office_address_zipcode,office_address_city,office_address_country,office_address_telephone,office_address_fax,bank_code,bank_ascription,bank_iban,bank_accountnumber,bank_nationalbic,bank_bic,bank_address_line1,bank_address_line2,bank_address_line3,bank_address_line4,bank_address_line5,bank_address_line6,bank_address_zipcode,bank_address_city,bank_address_country,bank_address_telephone,bank_address_fax,TableStart:details,TableEnd:details,details_detail_invdate,details_detail_duedate,details_detail_invnumber,details_detail_origvalue,details_detail_value,details_detail_origbasevalue,details_detail_basevalue,details_detail_trscode_@name,details_detail_trsnumber,origvalue,value,currency,valuetext,TableStart:cheque_details,TableEnd:cheque_details,cheque_details_detail_invdate,cheque_details_detail_duedate,cheque_details_detail_invnumber,cheque_details_detail_origvalue,cheque_details_detail_value,cheque_details_detail_origbasevalue,cheque_details_detail_basevalue,cheque_details_detail_trscode_@name,cheque_details_detail_trsnumber,millions,hundreds_of_thousands,tens_of_thousands,thousands,hundreds,tens,units,cents

Dit bestand kan opslagen worden in Twinfield.csv en vervolgens gebruikt worden bij het invoegen van een “Mail merge field”. Vervolgens kun je je sjabloon helemaal naar wens inrichten en opslaan in het ODF Text Document (.odt) formaat.

Zodra het sjabloon geüpload moet worden naar Twinfield is een bestandsnaam met de extensie .doc, .dot, .docx of .dotx nodig. Bij het uploaden van andere bestanden zal Twinfield de volgende foutmelding weergeven:

Selecteer een DOC-, DOT-, DOCX- of DOTX-bestand.

Als we ons ODF Text Document echter opslaan volgens het “” of “” formaat geeft Twinfield de volgende foutmelding:

De Word-sjabloon bevat geen samenvoegvelden.

Daarom slaan we ons bestand niet op volgens dit formaat maar wijzigen we ons “bestandsnaam.odt” simpelweg naar “bestandsnaam.odt.dot”. Vreemd genoeg kan Twinfield het ODF Text Document met een geldige extensie gewoon correct verwerken.

Helaas werken niet alle aspecten van een ODF Text Document even goed in Word en dus Twinfield. Zo wordt de opmaak van afbeeldingen en frames niet altijd goed over genomen. Dit probleem is echter vrij eenvoudig te omzeilen door puur met een tabellen opmaak te werken.

• Pronamic logo (PNG)
• Pronamic Twinfield factuur sjabloon (ODT)
• Pronamic Twinfield factuur voorbeeld (PDT)

UPDATE wp_usermeta SET meta_key = REPLACE(meta_key, 'wp_', 'nieuweprefix_') WHERE meta_key LIKE 'wp\_%';

Via een aantal andere websites kwam ik er achter dat ook de ‘options’ tabel de WordPress database prefix wordt gebruikt. Daarom zal waarschijnlijk ook de volgende query uitgevoerd moeten worden:

UPDATE wp_options SET option_name = REPLACE(option_name, 'wp_', 'nieuweprefix_') WHERE option_name LIKE 'wp\_%';

Bovenstaande queries gaat echter fout zodra de WordPress database prefix terug komt in de optie naam of de user meta key.

Zal na het uitvoeren van de query gewijzigd worden naar:

De “Change DB Prefix” plugin lijkt uitgerust zijn met de juiste queries:

http://plugins.trac.wordpress.org/browser/db-prefix-change/tags/1.1/db_prefix.php#L83

Meer informatie:

• http://digwp.com/2010/10/change-database-prefix/
• http://tdot-blog.com/wordpress/6-simple-steps-to-change-your-table-prefix-in-wordpress
• http://www.wpbeginner.com/wp-tutorials/how-to-change-the-wordpress-database-prefix-to-improve-security/