Toby's Comments
-
- Support
- reverb broadcast integration
-
Toby Waterhole Founder
Dec 13, 2024 Hi @Gabriel Silva, welcome to the community and thanks for your question!
Waterhole's server-side text formatting is powered by the s9e\TextFormatter library and there doesn't seem to be a LaTeX plugin available out of the box unfortunately!
In theory, you probably need to implement your own TextFormatter plugin to recognise LaTeX between certain delimiters, and either parse it on the server-side with something like php-latex, or output it in a certain tag that can then be rendered on the client-side by something like KaTeX.
The Formatting docs contain more information about how to interact with Waterhole's instance of TextFormatter.
-
Toby Waterhole Founder
Dec 13, 2024 In reply to James PenceJames PenceDec 12, 2024 I did and the toWaterholeUser function is getting the values to populate the form, but the form is still showing and expecting the Create Account submission button to be pressed to actually add the us...Hi @James Pence, this is a current limitation of the Laravel auth integration, to be added in a future release. Your proposed workaround sounds reasonable - let me know how this goes, here to answer any questions if needed.
-
- Support
- Embedding a Video Test
Toby Waterhole FounderNov 7, 2024 In reply to TOWUKTOWUK towuk.ruNov 3, 2024 hi, s9\TextFormatter on github abandoned? and s9e fork?s9e\TextFormatter is an original project under active development.
-
Answer Toby Waterhole FounderNov 7, 2024 That's correct - there are no functional restrictions if license validation fails. However, as stated in the Software Licence, you do need to purchase a license in order to run Waterhole in a production environment.
-
- Support
- Dublicate config remove
Toby Waterhole FounderNov 7, 2024 Hi @TOWUK,
These configuration duplicates are intentional, allowing configuration settings to be overridden at the environment level. Please see the Waterhole docs and the Laravel docs on configuration and environment variables.
Regarding the missing
ru
translations, please refer to the Localization docs - you could try a local override to fill in the missing translations, and then follow the steps to contribute back to the Waterhole repository (theru
translation is found here). -
- Support
- Embedding a Video Test
Toby Waterhole FounderOct 27, 2024 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'); });
-
- Development
- Reply Chaining
Toby Waterhole FounderSep 27, 2024 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.
-
- Blog
- Waterhole 0.4
Toby Waterhole FounderSep 27, 2024 In reply to riegel02riegel02Sep 20, 2024 Any ETA on the next update? (not pushing, just curious)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!
-
Toby Waterhole Founder
Sep 16, 2024 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.
-
Toby Waterhole Founder
Sep 1, 2024 Hi @Pete Swan, thanks for your question.
Take a look at the Laravel Authentication Integration docs. When implementing the
HasWaterholeUser
trait on your application'sUser
model, you will want to override thetoWaterholeUser()
method so that it only returns aPendingUser
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, ); }
-
- Support
- Hardering Waterhole
Toby Waterhole FounderJul 23, 2024 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.
-
- Lounge
- The Waterhole stack
Toby Waterhole FounderJul 23, 2024 In reply to StormlightStormlightJul 20, 2024 @Toby I'm currently using Livewire alongside Waterhole but after reading this, I am considering switching to Hotwire. I started my project off with the Waterhole Skeleton Repo (composer create-projec...In general, yes, it's wise to add a package you explicitly depend on to your project's
composer.json
file, rather than assuming that it is included via one of your other dependencies. This way you can specify your own version constraint, and then if there is an incompatibility between the version you depend on and the version Waterhole depends on, Composer will yell at you.If you want to depend on a version of the package that Waterhole is not compatible with, then you would need to either wait for Waterhole to update or separate Waterhole into its own project.
-
- Support
- Dose it support RTL?
Toby Waterhole FounderJul 18, 2024 There is currently no support for RTL, but this is something I'd like to add in the future.
-
- Development
- How Can We Generate RSS Feeds?
Answer Toby Waterhole FounderJul 17, 2024 Waterhole exposes an RSS feed for all posts (as you've linked), and each channel (e.g. https://waterhole.dev/community/channels/blog/posts.rss). In the future we may add feeds for comments/specific posts too.
You can configure the core JS setup in
config/waterhole/system.php
underecho_config
. Replace it with whatever config you would need to use for Reverb, per the Laravel Broadcasting docs.