wishthis
wishthis is a self-hosted platform to create, manage and view your wishes for any kind of occasion.
Prerequisites
We’re using PHP in the stable version 8.2:
[isabell@stardust ~]$ uberspace tools version use php 8.2
Selected PHP version 8.2
[isabell@stardust ~]$
You’ll need your MySQL credentials. Get them with my_print_defaults:
[isabell@stardust ~]$ my_print_defaults client
--default-character-set=utf8mb4
--user=isabell
--password=MySuperSecretPassword
[isabell@stardust ~]$
Your website domain needs to be set up:
[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$
Installation
Note
Make sure wishthis is setup via a domain directly and not running inside a sub-folder.
cd to your DocumentRoot, then clone the wishthis repository. You can find the latest stable version on the release notes.
[isabell@stardust ~]$ cd /var/www/virtual/$USER/html
[isabell@stardust html]$ rm -f nocontent.html
[isabell@stardust html]$ git clone -b stable https://github.com/wishthis/wishthis.git .
[isabell@stardust html]$
After cloning the repository, you need to create an additional folder:
[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/src/
[isabell@stardust src]$ mkdir cache
[isabell@stardust src]$
Create database
While not technically necessary, it is recommended to create a single-purpose MySQL database for whishthis:
[isabell@stardust ~]$ mysql --verbose --execute="CREATE DATABASE ${USER}_wishthis"
--------------
CREATE DATABASE isabell_wishthis
--------------
[isabell@stardust ~]$
Finishing installation
Point your browser to https://isabell.uber.space/ The built-in setup should start. Follow the instructions, enter your database credentials and the name of the database you just created, and register your user account.
Updates
Note
Check the release notes regularly to stay informed about the newest version.
Run git pull in the wishthis directory to pull the latest changes from upstream.
[isabell@stardust ~]$ cd ~/html
[isabell@stardust html]$ git pull origin stable
[isabell@stardust html]$
Optional steps
Disabling registration
By default, registration is open to anyone. If you have registered an account for yourself and want to disable registration, you need to change the value in the config file:
[isabell@stardust ~]$ nano ~/html/src/config/config.php
[isabell@stardust config]$
/**
* Miscellaneous
*/
define('DISABLE_USER_REGISTRATION', true);
Acknowledgements
Warning
wishthis v.1.1.1 still has a bug where German special letters (umlauts) are not correctly displayed: https://github.com/wishthis/wishthis/issues/80
This guide is based on the official wishthis readme.
Tested with wishthis v1.1.1 and Uberspace 7.15.14
Written by: Kevin Jost <https://github.com/systemsemaphore>