85 lines
3.5 KiB
Markdown
85 lines
3.5 KiB
Markdown
|
|
|
|
# Make a wish
|
|
|
|
wishthis is a simple, intuitive and modern wishlist platform to create, manage and view your wishes for any kind of occasion ([demo](https://wishthis.online)). Currently, wishthis is available in **99** different locales!
|
|
|
|
## :desktop_computer: Screenshots
|
|
|
|
| Home | Wishlists |
|
|
| ---------------------------------------------------- | ------------------------------------------------------------------- |
|
|
|  |  |
|
|
|
|
## :family_man_man_boy: Join the conversation
|
|
|
|
[](https://discord.gg/WrUXnpNyza)
|
|
[](https://matrix.to/#/#wishthis:matrix.org)
|
|
|
|
## :heavy_check_mark: Requirements
|
|
|
|
- Apache or Nginx
|
|
- PHP 8.1 - PHP 8.2
|
|
- [intl](https://www.php.net/manual/en/book.intl.php)
|
|
- MySQL/MariaDB
|
|
- [MJML](https://mjml.io/api) api keys (not required and used for rendering emails. Make sure [sendmail](https://www.php.net/manual/en/mail.configuration.php) is configured properly.)
|
|
|
|
## :hammer: Installation
|
|
|
|
### Git (recommended)
|
|
|
|
```
|
|
git clone -b stable https://github.com/wishthis/wishthis.git .
|
|
```
|
|
|
|
Note: after pulling updates for a new version you might be prompted to update the database schema in the wishthis user interface (if necessary). Make sure you are logged in.
|
|
|
|
### Manual
|
|
|
|
Download the code using the [stable branch](https://github.com/wishthis/wishthis/tree/stable) and upload it to your server.
|
|
|
|
Note: You will have to manually update wishthis by replacing all files with the changes from the `stable` branch.
|
|
|
|
### Note
|
|
|
|
Make sure wishthis is setup via a domain directly and not running inside a sub-folder.
|
|
|
|
### Attention! The installer is broken in `v1.0.0`!
|
|
|
|
To work around this, you can manually create a `/src/config/config.php` (please copy the `/src/config/config-sample.php`) and **remove** the part with the database information (currently four php constants).
|
|
|
|
The installer should appear now. Make sure the `config.php` is writeable. After the isntallation has complete you can make the config read-only again.
|
|
|
|
## :trophy: Contributing
|
|
|
|
### As a tester
|
|
|
|
In the wishthis plattform, navigate to:
|
|
|
|
1. Account -> Profile
|
|
1. Preferences
|
|
|
|
And set your channel to "Release candidate". Make sure to give feedback!
|
|
|
|
### As a translator
|
|
|
|
Localisation is currently done via Transifex.
|
|
|
|
https://www.transifex.com/wishthis/wishthis/
|
|
|
|
### As a sponsor
|
|
|
|
Time spent on wishthis is time not doing for-profit work. Of course there is no expectation but if you would still like to show your appreciation, you can here. It is very appreciated!
|
|
|
|
[](https://github.com/sponsors/grandeljay)
|
|
|
|
### As a developer
|
|
|
|
To setup your development environment you currently have two possibilities:
|
|
|
|
1. Git
|
|
|
|
Clone this repository and you're good to go!
|
|
|
|
1. Docker
|
|
|
|
An official Docker image is also available: https://github.com/wishthis/docker. It's created and maintained by [Hiobi](https://github.com/Hiobi), thanks!
|