Page 1 of 9

[ABD] Board Notices Manager

Posted: Wed Jul 22, 2015 4:08 pm
by FredQ
Extension Name: Board Notices Manager
Author: FredQ

Extension Description:

This extension will help you manage various notices at the top of all the pages.
This is not the same as an announcement. An announcement is global, whereas notices are contextual.

You can configure the notice to be dismissible (either forever, or it will come back after some time). Guest users can also dismiss a notice (although it will come back if they clear their cookies)

Please note, in version 1 you can only display one notice at a time. Displaying multiple notices is for a version 2

A few examples:
  • Display a message to bots only (the notice is the first piece of text indexed by robots so it's likely to appear as a description on search engine results)
  • Display a message to guests asking them to register
  • Display a welcoming message to users who registered today
  • Display a welcoming message asking you to write an introduction if you never posted yet.
  • Display a reminder to check the board rules forum
  • Display a congratulation message when the user reaches a high rank
  • Congratulations for your 1,000th post
  • Congratulations for your 5th year registration anniversary
  • Some warning that you're browsing a specific forum (like a read-only section)
  • Display a happy birthday message on your birthday.
  • Wishing a happy Christmas day every 25th December
  • Alert that you haven't posted for more than 2 weeks!
  • etc.
This extension is in the beta stage: even though the code base is fairly stable and unit tested, it might not ready to be installed on a production board.

English is not my native language, so feel free to fix the default language files :roll:


Extension Version: Image

Image
As I was upgrading the extension to phpBB 3.2 I realised it was getting difficult to keep a compatibility with phpBB 3.1
Please tell me if you desperately need compatibility with phpBB 3.1 and I'll see what I can do.

Features:

Here are all the rules that are already implemented:
  • Birthday
  • Never posted (the post count includes posts waiting for moderation)
  • Number of active posts equals to (by active I mean visible, which is approved and non-deleted)
  • Number of active posts less than
  • Number of active posts more than
  • Member of a usergroup
  • Member of a usergroup (and is the default group)
  • User is logged in
  • User is not logged in
  • User rank
  • User current board language
  • User current style (works with Guest styles if you have Quick Style extension installed)
  • Current forum the user is browsing
  • Registration anniversary
  • Has not posted for n days
  • On a specific date, and/or day and/or month and/or year
  • Has posted in some selected forums
  • Has not posted in a selection of forums
  • User is at the board index (or not)
  • User has never visited any of these forums
  • User has not visited any of these forums for x day(s)
  • User registered less than x day(s)
  • (New) User registered before a date
  • (New) User registered after a date
  • (New) User is browsing some specific topic(s)
A number of variables can be specified in the notice, like:
{SESSIONID}, {USERID}, {USERNAME}, {LASTVISIT}, {LASTPOST}, {REGISTERED}
and also some other that can be used combined with a rule providing them:
{AGE}, {ANNIVERSARY} (registration date), {RANKID}, {RANK}, {POSTS} (total number of user posts), {GROUPID}, {GROUPNAME} (default group only)

With these variables, you can show personalized messages. The message:

Image

will be displayed like this:

Image

Extension Download:

Github repository: https://github.com/gouarfig/board-notices/

Download this archive: https://github.com/gouarfig/board-notic ... v0.5.3.zip
And copy all the files from the folder inside the zip to the folder [root of your phpBB]/ext/fq/boardnotices/


Screenshots

The Board Notice manager:

Image

An example of notice for guests:

Image


Code Coverage (unit tests & integration tests)

Code is analysed with SonarCloud Image Image

Re: [Dev] Board Notices Manager

Posted: Wed Jul 22, 2015 11:29 pm
by AdamsUKMB
Sounds cool.

Re: [Dev] Board Notices Manager

Posted: Thu Jul 23, 2015 9:32 am
by huytrang90
Sound great.!

Re: [Dev] Board Notices Manager

Posted: Sat Jul 25, 2015 1:58 pm
by Tuqe
Hi,

Nice job.
Does one just looks at the home page notice?

Re: [Dev] Board Notices Manager

Posted: Sat Jul 25, 2015 4:03 pm
by FredQ
Tuqe wrote: Does one just looks at the home page notice?
What do you mean?

Re: [Dev] Board Notices Manager

Posted: Sat Jul 25, 2015 4:52 pm
by KlausiMaus
Hi, I'm not able to add a rule, alway in add notice :roll:

Re: [Dev] Board Notices Manager

Posted: Sat Jul 25, 2015 5:05 pm
by FredQ
KlausiMaus wrote:Hi, I'm not able to add a rule, alway in add notice :roll:
Indeed :shock:

The extension is not finished :o
FredQ wrote:Finish the admin console: As of today the rules are to be written directly into the database.
If you add the rules with phpMyAdmin it will work though.

Re: [Dev] Board Notices Manager

Posted: Sat Jul 25, 2015 10:03 pm
by Tuqe
FredQ wrote:
Tuqe wrote: Does one just looks at the home page notice?
What do you mean?
I mean : Does not display more than one notice ? Did you understand?
Image

Re: [Dev] Board Notices Manager

Posted: Sat Jul 25, 2015 11:42 pm
by FredQ
Tuqe wrote: I mean : Does not display more than one notice ? Did you understand?
No, no more than one at a time. I suppose it's technically possible, but not something I had in mind. I could see to include it later. I want to finish the configuration first tough.

Re: [Dev] Board Notices Manager

Posted: Mon Jul 27, 2015 3:11 pm
by FredQ
Good news everyone!

I've released version 0.1.0 with an almost complete configuration module: You can now add and edit notices (but not delete them yet - although you can deactivate them if needed), and manage all the rules and conditions for each notice.

It's getting there ;)

Re: [Dev] Board Notices Manager

Posted: Mon Jul 27, 2015 5:59 pm
by Miri4ever
Wonderful extension really nice and useful. It might be good having a preview function to see how the messages looks like, because a lot of images could not be seen if a lot of custom roles setup.

I have my calendar there at mainpage, how to tell the extension to appear under the calendar if both using the same overall header code to appear ??

Re: [Dev] Board Notices Manager

Posted: Mon Jul 27, 2015 6:04 pm
by RMcGirr83
Miri4ever wrote:I have my calendar there at mainpage, how to tell the extension to appear under the calendar if both using the same overall header code to appear ??
That isn't possible with phpBB in it's current form as of today.

Re: [Dev] Board Notices Manager

Posted: Mon Jul 27, 2015 6:46 pm
by Miri4ever
Maybe but there is something in some extension who tells them to appear first before others. Somewhere is an counter for this, or it has to do with the name or witch exentsion enabled as last so it looks like.

Re: [Dev] Board Notices Manager

Posted: Mon Jul 27, 2015 7:05 pm
by FredQ
Miri4ever wrote:Wonderful extension really nice and useful. It might be good having a preview function to see how the messages looks like, because a lot of images could not be seen if a lot of custom roles setup.
Thank you ;)
It won't be easy to do a preview function using your current style, all inside the admin site. What I could propose you is to setup the text with the rule for administrators only or something similar, and when you're happy with it you change the rules for the real ones.
Miri4ever wrote:I have my calendar there at mainpage, how to tell the extension to appear under the calendar if both using the same overall header code to appear ??
Maybe it has to do with the order the extensions were installed? I haven't had a look at how events are managed.

Don't try on a live board though (Uninstalling board-notices will delete all notices)

Re: [Dev] Board Notices Manager

Posted: Mon Jul 27, 2015 8:22 pm
by falcon23
Can we make notice for one forum group?