Documenting GlotPress with phpDocumentor

The current GlotPress API documentation (October 2021) was generated by ApiGen. Last commit was made on April 4th, 2016.

The last ApiGen commit was made on 23 Apr 2018, so I think this tool is deprecated. Furthermore, I was not able to use it with PHP 7.4 and GlotPress, so I look for another tool. The most PHP used tool is phpDocumentor. In this post I explain how to use it with GlotPress.

Install phpDocumentor globally on the machine, using the .phar tool.

cd ~/code/utils
mkdir phpDocumentor
cd phpDocumentor

Get the last .phar URL.

wget https://github.com/phpDocumentor/phpDocumentor/releases/download/v3.1.2/phpDocumentor.phar

To run phpDocumentor, execute:

php phpDocumentor.phar run \ 
-d ~/code/wordpress/glotpress-env/glotpress.git \ 
-t ~/code/wordpress/glotpress-env/gp-docs \
--ignore "vendor/"

Where:

  • ~/code/wordpress/glotpress-env/glotpress.git is the GlotPress folder.
  • ~/code/wordpress/glotpress-env/gp-docs is the documentation folder.
  • vendor/ is the folder where Composer stores all the information. It is located in the root folder of the project.

How to setup a master-master replication system between two MySQL servers

In this post, I will go to explain how to set up a master-master replication system between two MySQL to replicate an existing database.

The MySQL master-master configuration is a master-slave configuration in both directions and allows us to get a high availability configuration because you have the same data in both servers and if one goes down you can still work with the live server.

Update the own URL when you add an SSL certificate in WordPress with the WP-CLI

When you add an SSL certificate to a WordPress site, you have to update all the own references on the website, changing the ‘http’ string to ‘https’.

In this post I will explain how to do it with the ‘search-replace‘ subcommand of WP-CLI.

Aprende a gestionar tu WordPress desde la línea de comandos en 10 minutos. WordCamp Madrid 2019

En este enlace (PDF, 509 kB, español) dejo las transparencias de la presentación «Aprende a gestionar tu WordPress desde la línea de comandos en 10 minutos» de la WordCamp Madrid del día 6 de abril de 2019.

También puedes escuchar el audio de una grabación previa a la presentación o descargarlo en formato MP3 (7,49 MB): «Aprende a gestionar tu WordPress desde la línea de comandos en 10 minutos».