Toby

s9e\TextFormatter is an original project under active development.

Hey @Tyler DuPont, while Waterhole will automatically embed .mp4 links, unfortunately embedding a YouTube video isn't as simple as appending the .mp4 extension to the URL.

However there is a TextFormatter plugin that can automatically embed YouTube videos (among other things). Take a look at Waterhole's Formatter documentation to learn how to configure the formatter, and the TextFormatter MediaEmbed plugin. The code will end up looking something like this:

use Waterhole\Extend;
use s9e\TextFormatter\Configurator;

Extend\Formatter::configure(function (Configurator $configurator) {
    $configurator->MediaEmbed->add('youtube');
});

Thanks for your question @Tom H. Waterhole doesn't support this currently, but the database and replies system has been designed with this in mind as a possible future addition. In theory this could be implemented now as an extension (by completely reimplementing the "show post" page) but it would require a decent amount of development work.

No ETA, but can confirm that the JSON API implementation is mostly complete (it will be read-only for now), as well as the changes to the extension API. It's not a particularly exciting release, but it's coming!

Hi @Gareth. If you've integrated Waterhole as a package into your Laravel app, then you can access the Waterhole models directly:

$posts = Waterhole\Models\Post::latest()->take(10)->get();

If your Waterhole installation is separate from your app, then an upcoming Waterhole release will contain a JSON API which will allow you to retrieve data from your Waterhole installation remotely.

Hi @Pete Swan, thanks for your question.

Take a look at the Laravel Authentication Integration docs. When implementing the HasWaterholeUser trait on your application's User model, you will want to override the toWaterholeUser() method so that it only returns a PendingUser object if the user has the correct role that allows them to access the forum:

    public function toWaterholeUser(): ?PendingUser
    {
        if (!$this->roles->contains(ROLE_ID)) {
            return null;
        }

        return new PendingUser(
            identifier: $this->getAuthIdentifier(),
            email: $this->email,
            name: $this->name,
        );
    }

Waterhole already requires the user to confirm their password when accessing the CP, so if you have a secure password it should already be pretty hardened. Multi-factor authentication is on the roadmap.

Probably not worth doing HTTP Basic Auth IMO, because it's not very secure. Restricting access per IP address could be a good extra measure.

There is currently no support for RTL, but this is something I'd like to add in the future.

The sidebar links can be managed in the Structure section of the Control Panel. Docs