Mass Actions

MIT license Latest Stable Version Total Downloads Donate

This extension adds the ability to perform grouped actions on discussions through checkboxes.
A future version might re-use the logic for users.

On the discussion list, use the checkbox control in the top left or hover a discussion to select.
Once discussions are selected, the controls on the top right will change to show available mass actions.

The list of buttons appearing depends on the permissions the actor has.

Change "View mass selection controls" permission in the admin panel to configure who can see the checkboxes.
This control is only visual, and doesn't impact REST API permissions or rate limiting.

Currently supported features:

  • Mark as read
  • Delete/restore (soft delete only)
  • Lock/unlock
  • Set tags (exact list)
  • Add tag (to existing list)

Technical details: current implementation uses existing REST API endpoints and loops through discussions client-side.
All API requests are dispatched at the same time, so this means there could be rate limiting issues.

This version has not been optimized for mobile.
It's probably a good idea to only make it visible to moderators for now.

The intent is to integrate this UI/feature into Flarum in a future release. Please leave feedback on your experience, so we can see what needs tweaking!

Installation

composer require clarkwinkelmann/flarum-ext-mass-actions

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

Thank you very much for this extension!
I will try immediately. I follow also some develop video made by you, thanks for the sharing.

I use the Synopsis extension.
When post are selected I get some issue with the text that is not readable:

img

Will be maybe nice have the text converted in white or in black when selected.

    peopleinside that's right, I didn't test with pinned discussions or search. This reminds me pinned should be added to the mass actions as well!

    I had to hard-code the color for each of the discussion list item elements, so I'm not surprised it needs more code for the excerpt. I'll try to take a look.

    The styling is very likely to break even more because it's using the primary color as background, so white might not always be the best text color.

    I have also not tested dark mode at all. It's probably horrible. That's for a future update 😇

        clarkwinkelmann thank you!
        For me dark mode works well and is currently the way to see text when topics are selected with this new extension.

        I have a suggestion: insert in the user settings page a option to activate or deactivate the multi select option so who has the right to use this extension can deactivate the function when is not necessary as may not be liked to have always active.

        I see there is another issue:
        I think this extension is useful if you need delete an user but before do you need and want delete all discussion started from this user. Opening the profile page and opening the relative tab of discussion the extension never allow to multi-select elements.

          17 days later

          Today I got the time to check this extension and it is super awesome. 🔥

          similarly, the move posts extension can also adopt bulk delete posts features.

          23 days later

          This is definitely a lifesaver...
          I am restructuring my forum and have moved multiple 1st level tag into 2nd level tags.
          In order to grant the new parent to all the old tags, i simply search:

          tag:2nd-level -tag:1st-level

          to locate all the posts not yet assigned with the new 1st level tag

          then with @clarkwinkelmann's tool I am able to swiftly update all the posts! you are amazing!

          a month later
          24 days later

          Version 1.1.0

          • Enabled discussion mass actions on user profile page
          • Added range selection through shift-click
          • Added permanent deletion action
          • Added sticky/unsticky action
          • Fixed title of selected discussions not changing color when discussion is unread
            a month later

            murdocklawless are the title texts the same? (popover when mouse is over button)

            I don't remember 100% if there are or are not 2 buttons with the same icon in the extension. I might have re-used an icon because there wasn't any better choice available. But the title text should be different if the same icon is reused.

                a month later

                clarkwinkelmann Could you try to recompile assets again and release new version? I'm seeing the same bug and I'm 99% sure that compiled assets have bug where sticky button uses mass-lock as key and overwrites "Lock discussion" button.

                    Version 1.1.1

                    • Fixed sticky control overriding lock control.
                    • Switch to CSS variable in Less to increase theming flexibility.

                    rob006 thanks, it wasn't just a compilation issue. The typo was in the source code as well 🤐

                      12 days later

                      Version 1.1.2

                      • Fix "cannot redeclare" error when disabling extension, thanks @rob006
                      • Fix tag controls continuing to appear if Tags is disabled while scoped permissions still exist

                      It's safe to remove the extension with Composer even after the redeclare error because this extension doesn't have anything to roll back, but I would still recommend installing this update prior to uninstallation if you plan to remove the extension, as the error could hide another error which you would miss.

                      a year later

                      Googol please contact FreeFlarum directly, there's nothing I can do. I believe they explain how to request new extensions in their documentation

                        5 months later

                        now the extension only can choose discuss, will you support posts in the future?

                          meihuak I would love to, but I don't know how to design the UI for it because it's very complicated to manage posts selections while inside discussion. It would also require some sort of alternate compact view for posts.

                          Which mass actions are you interested to use on posts ?

                              clarkwinkelmann now the function for discussions is good to use. thanks for your job. I want to choose some posts at the same time, then delete them. I think you can use the same UI of discussions.