Group Invitation

MIT license Latest Stable Version Total Downloads Donate

This extension creates sharable links that will let any user join the group that was associated with the invitation.

Screenshot

Invitation links can be created in the extension settings.
A link can optionally have a limited number of uses.

The number of uses for an invitation is recorded but is not public.
There is a generic "can no longer be used" error if the invitation has no usage left.

A permission controls who can use links.
Don't forget to set it to Members if you want anyone to be able to use links.

If a user sees "not allowed to use invitations" even though you allowed them, check:

  • That the user has verified their email
  • That the user has accepted the terms of use (if using FoF Terms)
  • That the user isn't suspended

This extension provides no way of removing groups.
If a user no longer wants to be part of a group, a moderator will have to remove the group manually through Flarum's user edit modal.

The word "group" has been used thorough this extension because it's the official name for the matching Flarum feature.
You can use the Linguist extension to adapt the naming based on your use case: role, badge, etc...

Installation

composer require clarkwinkelmann/flarum-ext-group-invitation

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.

Links

The development of this extension was sponsored by Cross from dillfrescott.com

    17 days later

    TOWUK where and what would it do?

    You can delete an invitation with the "Delete" button in the admin panel.

      Do we have a groups option ? Link me to it please.

      TOWUK There’s already a way to cancel invites through the admin panel. As for the user, just exit the tab if you don’t want to join the group via the link.

        3 months later
        7 days later
        2 months later
        9 days later

        clarkwinkelmann I look forward to this extension to support beta15, it is so fascinating to me, I think I will like it, hope you too.

          3 months later
          2 months later
          10 months later

          Stuck at here:

          Here is console:

          mount-redraw.jss:15 Error: Unbalanced curly braces in string: "{group grubuna katılmak için davet edildin!"
    at i.value (forum.js:2:353703)
    at i.value (forum.js:2:352861)
    at t.e.trans (forum.js:2:355304)
    at n.o.view (forum.js:359:3555)
    at Function.a (forum.js:2:140858)
    at forum.js:2:147298
    at p (forum.js:2:147685)
    at f (forum.js:2:143911)
    at forum.js:2:146371
    at p (forum.js:2:146576)
a @ mount-redraw.jss:15

          May be language pack bug.

            Version 1.0.1

            Smaller bundle size with Webpack 5

            Behind the scenes, typescript and Webpack 5 are now used. More typings have also been added to the PHP code.

            This update requires Flarum 1.2+ and PHP 7.4 or 8.x

            EDIT: I forgot to add the PHP 7.4 constraint to Composer, so you'll get an error at run time if you install this version on PHP 7.3. Tagging a new release won't solve the issue if the existing release continues to exist and I don't want to delete the existing release so I'll leave things like this.

            17 days later

            is it possible to add something like there's a number limit on how many users can a single user invite to the forum, and each user can invite like 2-3 new users

              lichengkun135 this extension doesn't allow users to invite other users. It wouldn't make any sense for groups unless you also had an extension that let users create their own groups.

              Maybe that's a feature you would like to see in the FoF Doorman extension as part of registration invitation (not group invitation)?

              Either way it's definitely something I can do as a sponsored extension. It would likely be a new extension though, I see no benefit in modifying this present extension that has a different use case.

                HasanMerkit go to vendor/flarum-lang/turkish/locale folder and edit clarkwinkelmann-group-invitation.yml

                at line 33 just add } at the end of the {group

                save the file.

                at the command line type php flarum cache:clear and enter.

                this is it.