Follow Tags Prompt

clarkwinkelmann · 2021-01-19T15:32:03+00:00

Follow Tags Prompt Prompt user for tags to follow after registration. This is a companion extension that requires FriendsOfFlarum Follow Tags to work. The modal will open for all new or existing users who have not clicked the "Continue" button present in the modal. If the modal is closed in any other way than the "Continue" button, it will open again on the next page refresh. The list of tags shown in the modal can be customized. By default, a button to access the modal is also added to the "Following" page. This can be disabled in the settings. The extension also contains two other unrelated features: Ability to make the "Following" page display all discussions without filtering for guests instead of showing an empty page. Ability to make the "Following" page the homepage (under Basics) Those options are disabled by default. Installation composer require clarkwinkelmann/flarum-ext-follow-tags-prompt if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Support This extension is under minimal maintenance. It was developed for a client and released as open-source for the benefit of the community. I might publish simple bugfixes or compatibility updates for free. You can contact me to sponsor additional features or updates. Support is offered on a "best effort" basis through the Flarum community thread. Sponsors: Talkie, Andrew MacLean Links GitHub Packagist

ctml

Excellent idea, I always love extensions that encourage users to be more active. Prompting users to follow tags that interest them right after signup is a great way to do just that. I had considered building something into my site (a hack, through DB) to force users to follow a predefine set of tags after sign-up but this is a much better solution. Thanks clark & sponsors!

ctml

Is there a way to reset the prompt for all users so it shows again on their next login? I tried looking through the DB to find a table or column where a flag might be stored, could have easily missed it though. For example if you do an overhaul over your tagging by adding/removing, perhaps I may want to re-prompt them (rarely, but on occasion).

clarkwinkelmann

ctml there's literally just one column added by this extension https://github.com/clarkwinkelmann/flarum-ext-follow-tags-prompt/blob/master/migrations/2020_09_08_alter_users_add_configured_column.php

Set clarkwinkelmann_follow_tags_configured_at to null on users table to reset.

ctml

clarkwinkelmann sweet.. I knew it must be in there somewhere, thanks clark!

ctml

If you set your home page to another supported page (such as tags or blog), the prompt won't ever come up unless you happen to refresh while on /all. Not a huge deal but just something I noticed once I changed my homepage.

clarkwinkelmann

ctml this is intentional behavior. The modal only opens on the IndexPage component https://github.com/clarkwinkelmann/flarum-ext-follow-tags-prompt/blob/0.2.0/js/src/forum/openAutomaticModal.js#L18

I think this was copied from the way fof/terms does it. This is to prevent the modal opening unexpectedly when directly accessing a discussion or profile.

But since it will always open after registration and doesn't have a banner at the top of the screen, I guess I could change the behavior to open on any page. If someone wants to sponsor a batch of changes I can include that in there.

ctml

clarkwinkelmann thanks, could you PM me here and we can discuss?

clarkwinkelmann

ctml you can reach out by email on my website or on Discord.

troymccann

Hmm. Just trying this out now to prompt users with access to a hidden tag to follow it. For users who can't see that tag, the prompt loads each time they sign in, and there's (rightfully) no options available to them.

Is there a way to make it not show if there are no options for a user to follow?

clarkwinkelmann

troymccann you mean the forum only has one hidden tag, and no other tags?

I suppose I could add a check for the number of tags on the forum before opening the modal.

troymccann

clarkwinkelmann No there are lots of tags. Some are hidden. In the setting's for this, though, I've told it to only work with one tag - which happens to be a hidden tag.

clarkwinkelmann

Version 0.2.1

Add compatibility with Flarum beta 16
Make modal open on custom homepages as well

Thanks @ctml for sponsoring the update.

enricodx

I don't fully understand what the "Show all discussions on the Following page for guests" do, since any guest can't see the Following page link 🤔

clarkwinkelmann

enricodx that's for when the Following page is set as homepage, which this extension also allows doing.

Otherwise it doesn't make much sense indeed.

enricodx

clarkwinkelmann Thanks!

clarkwinkelmann

Version 1.0.0

Added compatibility with Flarum 1.0+

Don't forget to set the extension version constraint to * or ^1.0 in your composer.json file before updating Flarum (as explained in Flarum's own upgrade guide)

Update sponsored by my GitHub Sponsors. Thanks for the support!

HasanMerkit

UI Bug:

clarkwinkelmann

HasanMerkit does the screenshot show the full viewport or does the modal appear like that on all screens including desktop computers? How many tags are listed in the modal?

If it is the full viewport, are there devices where this is likely to happen? Is it a mobile phone in landscape orientation?

HasanMerkit

clarkwinkelmann not happened after adding more tags.
1920x1080 resolution on Windows. (Latest Google Chrome)

May be required test with 1 tag website.

HasanMerkit

Plugin enabled: Tags are corrupted

Disabled: