Toby

Founder

Waterhole Australia waterhole.dev Joined Nov 7, 2022 Last seen Dec 23, 2024

Newest Top

1. Support
2. Integration with an existing Laravel app
Toby Waterhole Founder Jul 7, 2023
Hi @Joe,

Yes, this is something that I'm planning to add official support/docs for. For now it's untested and probably fairly limited (eg. there's no way to configure a separate DB connection for Waterhole). But the gist would be:
1. composer require waterholeforum/core into your Laravel project
2. Follow the rest of the Waterhole installation instructions
3. Configure Waterhole's path prefix
In terms of auth integration, there's no solution at the moment but it's also on the roadmap for one of the next couple releases.
Show ⁨1⁩ ⁨reply⁩
1 Like Loading...

Reply Actions
1. Resources
2. To install Waterhole on a shared hosting environment
Toby Waterhole Founder Jun 21, 2023

Please note that running Waterhole on shared hosting is not officially supported.

Reply Actions
1. Development
2. How to add a Stimulus controller?
Answer
Toby Waterhole Founder Jun 21, 2023
Hi @mtdmy, you'll need to:
1. Create a new Stimulus controller at resources/js/controllers/hello_controller.js, and then register it with Waterhole's Stimulus instance in resources/js/app.js:
```
import HelloController from './controllers/hello_controller';

window.Stimulus.register('hello', HelloController);
```
1. Set up a JavaScript compilation step - probably the easiest way is to use Laravel Mix. Output your compiled JavaScript to resources/dist/app.js.
2. Add this script to Waterhole's JavaScript bundle in your service provider:
```
Extend\Script::add(resource_path('dist/app.js'));
```
Hopefully that's enough to get you started – let me know if you have any specific questions.
Show ⁨2⁩ ⁨replies⁩

Reply Actions
1. Support
2. Keep me logged in
Toby Waterhole Founder Jun 21, 2023

Hey @René! It doesn't seem to happen to me on this forum, at least

Checking the "Remember me" box should set a cookie called remember_web_[random string] with an expiry of 1 year. Can you confirm that this is being set correctly?

Reply Actions
1. Development
2. When I select a piece of text, the selection event is not triggered
Answer
Toby Waterhole Founder Jun 13, 2023

In reply to binks

This seems to be a conflict between Turbo Drive (a library that Waterhole uses to speed up page navigation) and this extension. Turbo Drive is simply replacing the <body> via XHR, so it's a bug with the extension if it can't handle that. I would suggest contacting the extension developer to submit a bug report.

A workaround is to reload the page, and then it will work again (up until you navigate to another page).

Reply Actions
1. Development
2. When I select a piece of text, the selection event is not triggered
Toby Waterhole Founder Jun 13, 2023

@binks What browser extension are you using? (So I can investigate the cause)

Show ⁨1⁩ ⁨reply⁩

Reply Actions
1. Showcase
2. Using Waterhole for our Community Feature Request Forum
Toby Waterhole Founder Jun 4, 2023

In reply to Wulfheart

Probably something pretty similar to DiscourseConnect, which allows authentication to be handled completely off-site.

Reply Actions
1. Development
2. Paywall for User Groups
Answer
Toby Waterhole Founder Jun 4, 2023
Yep, @Wulfheart is correct. Waterhole doesn't currently support any integration with Zapier or Trigger – though a JSON API is on the roadmap which would potentially make these possible.

For now, the recommended way would be to write some Laravel code to listen for a Stripe webhook and then add the Waterhole user to the desired group:
```
use Waterhole\Models\User;

$user = User::where('email', $email)->firstOrFail();
$user->groups()->attach(5);
```
1 Like Loading...

Reply Actions
1. Ideas
2. Suggestion for the display format when showing replies
Toby Waterhole Founder Jun 4, 2023

Thanks for the suggestion @Subarist. In the next release, comments will have a stacked layout on small screens (the body and replies will be full-width beneath the avatar/username), making them much more readable.

1 Like Loading...

Reply Actions
1. Development
2. Is there a public roadmap?
Toby Waterhole Founder Jun 4, 2023

Hey @Manuel, good question!

I don't currently have a well-defined roadmap to publish, except to say that the focus for the next few releases will be mostly on adding essential moderation features that Waterhole is missing (eg. pinned posts, soft-deletion, reporting, anti-spam), as well as integration features (like a JSON API).

The roadmap beyond that is a work-in-progress that will be influenced by public demand and client requests. Hopefully at some stage I will be able to publish a more concrete roadmap.

Feel free to add your most desired features to the Ideas channel so they can receive votes from others, and we can discuss exact implementations etc.

4 Love Loading...

Reply Actions
1. Support
2. UTF-8 display Issues
Answer
Toby Waterhole Founder Jun 4, 2023

Thanks for these reports @Subarist, they will be fixed in the next release. In the future, it would be a great help if you could post bug reports to the GitHub issue tracker

Show ⁨1⁩ ⁨reply⁩

Reply Actions
1. Support
2. Class "Locale" not found
Toby Waterhole Founder Jun 4, 2023

Hi @Adeala Ademola, have you tried all of the steps in the Troubleshooting documentation? When posting in the Support channel, please include as much information as possible, including any relevant information in the logs, and detail what debugging steps you have tried (eg. clearing the cache).

Reply Actions
1. Support
2. Only English Interface Displayed When Not Logged In, Despite Different Language Settings
Toby Waterhole Founder Jun 4, 2023

In reply to Subarist
Can we specify a default language?

In most cases you shouldn't need to, since Waterhole defaults to the closest matching preferred language to the Accept-Language header sent by the browser. If there's no good match, it will default to the first locale defined in Extend\Locales (English). If you needed to change this you could remove the English locale:
```
Extend\Locales::remove('en');
```
Show ⁨1⁩ ⁨reply⁩

Reply Actions
1. Ideas
2. Text width
Toby Waterhole Founder May 30, 2023
Thanks for the feedback @René! You're right – I've adjusted the default theme slightly in 0.2. May make further adjustments in the future, though probably won't take it all the way down to 70 characters.

Couple things you can tweak with custom CSS:
```
.container {
    max-width: 72rem;
}

/* and/or */

:root {
  --measure: 92ch;
}
```
1 Love Loading...

Reply Actions
1. Support
2. Only English Interface Displayed When Not Logged In, Despite Different Language Settings
Toby Waterhole Founder May 30, 2023
I'm not sure I quite understand the problem, so I'll just explain how the language system works.

In order to become available, languages must be registered using the Locales extender. For example, in WaterholeServiceProvider, you would add:
```
Extend\Locales::add('Traditional Chinese', 'zh-Hant');
```
Waterhole uses the following algorithm to determine which language to use:
1. If the user has selected a language, use that. (If they are logged in, it's stored in their preferences; otherwise it's stored in the session.)
2. Otherwise, use the closest matching preferred language from the Accept-Language header sent by the browser.
The app.locale setting is not actually used for Waterhole requests.

You should keep app.fallback_locale set to en so that any strings that don't have a zh translation will fall back to English instead of printing out the translation key.
Reply Actions

Toby

⁨Toby⁩'s Comments