Topic prefixes now available

Discussion forum for Extension Writers regarding Extension Development.
User avatar
DavidIQ
Customisations Team Leader
Customisations Team Leader
Posts: 17059
Joined: Thu Jan 06, 2005 1:30 pm
Location: Fishkill, NY
Name: David Colón
Contact:

Topic prefixes now available

Post by DavidIQ » Fri Dec 02, 2016 3:31 pm

A few months ago we had completed the official Topic Prefixes extension, with its creation intended for use here on phpBB.com in the Extension and Styles development forums. We are proud to announce that this extension has been configured for immediate use in the Extensions in Development forum by everyone that either creates a topic or modifies their initial post to change their topic prefix:
topicprefixes.png
When creating a topic for developing an extension there has always been a topic prefix requirement, but with the advent of extensions this has become a little difficult for users simply looking for extensions that apply to their particular major version, be it 3.1, 3.2, and beyond since extensions are what's available for both 3.1 and 3.2 and any major phpBB version beyond that. Some extensions might work fine with both 3.1 and 3.2 while others either only work with 3.1 or only work with 3.2. With the availability and usage of these prefixes now any user can look at the list of Extensions in Development topics and figure out if it applies to their version or not by looking at the title.

There are a few options to choose from so here are some examples to give the general gist of it:
  • [3.1][DEV] - The extension is in development and targets the 3.1 platform.
  • [3.1][3.2][RC] - The extension is in release candidate stage and targets 3.1 and 3.2.
  • [3.2][ALPHA] - The extension is in the alpha development stage and targets the 3.2 platform.
  • [BETA] - The extension is in the beta development stage and works on any version. (Use sparingly and knowingly)
The explanation of what DEV, ALPHA, RC, etc. actually represents in the extension's development process is in the aforementioned rules.

If you run into any issues using the topic prefixes or have any comments on changing something regarding the implementation of this extension and its features please let us know.

Note that this extension is available in our Customisations Database here: https://www.phpbb.com/customise/db/exte ... cprefixes/
Apply to become a Jr. Extension Validator
My extensions | In need of phpBB services? | Was I helpful today?
No unsolicited PMs unless you're planning on asking for paid help.

User avatar
david63
Registered User
Posts: 16540
Joined: Thu Dec 19, 2002 8:08 am
Location: Lancashire, UK
Name: David Wood
Contact:

Re: Topic prefixes now available

Post by david63 » Fri Dec 02, 2016 3:41 pm

Not sure I quite follow this.

Take for example [3.2][RC] - does that refer to phpBB 3.2-RC or is it saying that the extension is at RC stage for use on phpBB 3.2?

Would it not be clearer if it was [3.2 RC][DEV]etc. meaning that the extension is at DEV stage and works on phpBB 3.2-RC?
David
Remember: You only know what you know and - you don't know what you don't know!
My CDB Contributions | How to install an extension
I will not be accepting translations for any of my extensions in Github - please post any translations in the appropriate topic.
No support requests via PM or email as they will be ignored

User avatar
DavidIQ
Customisations Team Leader
Customisations Team Leader
Posts: 17059
Joined: Thu Jan 06, 2005 1:30 pm
Location: Fishkill, NY
Name: David Colón
Contact:

Re: Topic prefixes now available

Post by DavidIQ » Fri Dec 02, 2016 3:47 pm

It would be that it works with 3.2 since we are not requiring the specific release version in the prefix, i.e. you don't need to have 3.1.10 or 3.2-RC2 as the prefix. The major release version should suffice for purposes of taking a glance at the topics list and determining if the user should even look at the extension for their own usage.
Apply to become a Jr. Extension Validator
My extensions | In need of phpBB services? | Was I helpful today?
No unsolicited PMs unless you're planning on asking for paid help.

User avatar
VSE
Extensions Development Coordinator
Extensions Development Coordinator
Posts: 4917
Joined: Sat Jan 17, 2009 9:37 am
Location: Los Angeles, CA
Name: Matt Friedman
Contact:

Re: Topic prefixes now available

Post by VSE » Fri Dec 02, 2016 11:18 pm

Normally you can just use the standard issue
[RC], [DEV], [BETA] etc...

And by normally I mean you are developing for the currently released version of phpBB. As of today that is still the 3.1 branch.

If you want to be more specific about which version you are developing for, your branch options are:
  • [3.1][DEV] a dev version for phpBB 3.1 and not tested on anything higher (ie: 3.1 only).
  • [3.1+][DEV] a dev version for phpBB 3.1 AND higher versions (ie: 3.1, 3.2, 3.3).
  • [3.2][DEV] a dev version for phpBB 3.2 and not tested on anything higher or lower (ie: incompatible with phpBB 3.1).
The idea is communication, so nobody installs a [3.2][DEV] labeled extension on a phpBB 3.1 board, for example.
Dictated but not read.
Official phpBB Extensions My Extensions & MODs
Please do not PM me for support.

User avatar
DavidIQ
Customisations Team Leader
Customisations Team Leader
Posts: 17059
Joined: Thu Jan 06, 2005 1:30 pm
Location: Fishkill, NY
Name: David Colón
Contact:

Re: Topic prefixes now available

Post by DavidIQ » Fri Dec 02, 2016 11:59 pm

Thanks. I've modified the first post to have more clarifying information as I obviously didn't do a good job of explaining the purpose/usage of this. :?
Apply to become a Jr. Extension Validator
My extensions | In need of phpBB services? | Was I helpful today?
No unsolicited PMs unless you're planning on asking for paid help.

User avatar
RMcGirr83
Recognised Extension Developer
Posts: 21034
Joined: Wed Jun 22, 2005 4:33 pm
Location: Your display
Name: Rich McGirr
Contact:

Re: Topic prefixes now available

Post by RMcGirr83 » Sat Dec 03, 2016 11:31 am

And if the extension works on both 3.1 and 3.2?
In times of change, learners inherit the earth, while the learned find themselves beautifully equipped to deal with a world that no longer exists - Eric Hoffer
Former Modifications/Extensions Team Member | My extensions
Appreciate the extensions/mods/support then buy me a beer
All requests for support via PM will be ignored

User avatar
DavidIQ
Customisations Team Leader
Customisations Team Leader
Posts: 17059
Joined: Thu Jan 06, 2005 1:30 pm
Location: Fishkill, NY
Name: David Colón
Contact:

Re: Topic prefixes now available

Post by DavidIQ » Sat Dec 03, 2016 11:56 am

Then 3.1+ would be the option you'd want. Haven't really decided if we just need to split that off into [3.1][3.2] instead of [3.1+].
Apply to become a Jr. Extension Validator
My extensions | In need of phpBB services? | Was I helpful today?
No unsolicited PMs unless you're planning on asking for paid help.

User avatar
HiFiKabin
Community Team Member
Community Team Member
Posts: 4016
Joined: Wed May 14, 2014 9:10 am
Location: Swearing at the PC, UK
Name: James
Contact:

Re: Topic prefixes now available

Post by HiFiKabin » Sat Dec 03, 2016 11:58 am

DavidIQ wrote:Then 3.1+ would be the option you'd want. Haven't really decided if we just need to split that off into [3.1][3.2] instead of [3.1+].
I would think that most users would think ]3.1.+] would just apply to the 3.1.x branch

[3.1][3.2] is much clearer IMHO

User avatar
RMcGirr83
Recognised Extension Developer
Posts: 21034
Joined: Wed Jun 22, 2005 4:33 pm
Location: Your display
Name: Rich McGirr
Contact:

Re: Topic prefixes now available

Post by RMcGirr83 » Sat Dec 03, 2016 12:06 pm

Agree, 3.1+ means, at least to me, will work on any 3.1 version.

Dare I ask what happens if an extension works on 3.1, 3.2, 3.3, and 4.0? :lol:
In times of change, learners inherit the earth, while the learned find themselves beautifully equipped to deal with a world that no longer exists - Eric Hoffer
Former Modifications/Extensions Team Member | My extensions
Appreciate the extensions/mods/support then buy me a beer
All requests for support via PM will be ignored

User avatar
DavidIQ
Customisations Team Leader
Customisations Team Leader
Posts: 17059
Joined: Thu Jan 06, 2005 1:30 pm
Location: Fishkill, NY
Name: David Colón
Contact:

Re: Topic prefixes now available

Post by DavidIQ » Sat Dec 03, 2016 12:18 pm

Well once 3.1 reaches the point in the maintenance and release schedule (which will probably be adjusted) where no more extensions are accepted for it the prefixes will be adjusted so 3.1 is no longer a selectable option. Same for 3.2, 3.3, etc. as we progress through the versions. Extension authors shouldn't feel the need to support those versions, but the free-for-all [DEV], [ALPHA], [BETA] and [RC] options are still available as well which should indicate it works with any version.
Apply to become a Jr. Extension Validator
My extensions | In need of phpBB services? | Was I helpful today?
No unsolicited PMs unless you're planning on asking for paid help.

Paul
Infrastructure Team Leader
Infrastructure Team Leader
Posts: 25388
Joined: Sat Dec 04, 2004 3:44 pm
Location: The netherlands.
Name: Paul Sohier
Contact:

Re: Topic prefixes now available

Post by Paul » Sat Dec 03, 2016 12:33 pm

Or I guess you can use no version prefix at all? :)
Knock knock
Race condition
Who's there?

My BlogMy Photosmy phpBB Extensionscustom phpBB work & Development

User avatar
david63
Registered User
Posts: 16540
Joined: Thu Dec 19, 2002 8:08 am
Location: Lancashire, UK
Name: David Wood
Contact:

Re: Topic prefixes now available

Post by david63 » Sat Dec 03, 2016 12:53 pm

DavidIQ wrote:... we are not requiring the specific release version in the prefix, i.e. you don't need to have 3.1.10 or 3.2-RC2 as the prefix.
But specific versions can be necessary when an extension is dependant on events being added in a particular version.
David
Remember: You only know what you know and - you don't know what you don't know!
My CDB Contributions | How to install an extension
I will not be accepting translations for any of my extensions in Github - please post any translations in the appropriate topic.
No support requests via PM or email as they will be ignored

User avatar
DavidIQ
Customisations Team Leader
Customisations Team Leader
Posts: 17059
Joined: Thu Jan 06, 2005 1:30 pm
Location: Fishkill, NY
Name: David Colón
Contact:

Re: Topic prefixes now available

Post by DavidIQ » Sat Dec 03, 2016 1:02 pm

david63 wrote:But specific versions can be necessary when an extension is dependant on events being added in a particular version.
Yes, the author has a field for specifying specific versions in the first post of the topic. This really isn't for that. It's more a way to tag extensions for 3.1, 3.2, etc.
Apply to become a Jr. Extension Validator
My extensions | In need of phpBB services? | Was I helpful today?
No unsolicited PMs unless you're planning on asking for paid help.

User avatar
DavidIQ
Customisations Team Leader
Customisations Team Leader
Posts: 17059
Joined: Thu Jan 06, 2005 1:30 pm
Location: Fishkill, NY
Name: David Colón
Contact:

Re: Topic prefixes now available

Post by DavidIQ » Sat Dec 03, 2016 2:54 pm

HiFiKabin wrote:[3.1][3.2] is much clearer IMHO
I've now changed the [3.1+] prefixes to be [3.1][3.2] for better clarity.

Thanks for the feedback, and Rich as well.
Apply to become a Jr. Extension Validator
My extensions | In need of phpBB services? | Was I helpful today?
No unsolicited PMs unless you're planning on asking for paid help.

User avatar
3Di
Former Team Member
Posts: 14225
Joined: Mon Apr 04, 2005 11:09 pm
Location: Milan (IT) Frankfurt (DE)
Name: Marco
Contact:

Re: Topic prefixes now available

Post by 3Di » Sat Dec 03, 2016 3:02 pm

Well done, useful.

It would have been nice to have also the" Extension's topic starter template" too.
But that's another story.
Please PM me only to request paid works. Thx.
Want to compensate me for my interest? Donate
My development's activity º PhpStorm's proud user
Extensions, Scripts, MOD porting, Update/Upgrades
👨‍🏫 | Take a tour to | The Studio | 👨‍🏫

Post Reply

Return to “Extension Writers Discussion”