These requests for comments/change have lead to an implemented feature that has been successfully merged into the 3.2/Rhea branch. Everything listed in this forum will be available in phpBB 3.2.
- Former Team Member
- Posts: 733
- Joined: Sun Oct 07, 2007 11:54 am
- Location: Stuttgart, Germany
While trying to make it easier to translate the FAQs, I'm removing the strange array we use there and switch to normal language strings.
As this already changes most of the content, we might aswell just move the FAQs to controllers.
Now there are multiple questions:
- Which routes should be used?
I would suggest using
/help/faq for https://area51.phpbb.com/phpBB/faq.php and
/help/bbcode for https://area51.phpbb.com/phpBB/faq.php?mode=bbcode
This allows other extensions to add their help sites under the same prefix.
- The second question is where to put the controller. We have multiple options there:
I think 1 and 3 would make sense, whereby 1 and 2 are easy and 3 requires the installer to enable exts afterwards...
- Using the feature as second namespace:
./phpbb/help/controller/faq.php (this is what the API PR uses atm: https://github.com/phpbb/phpbb/pull/3100/files )
- Using controller as second namespace:
- Moving it to an extension:
Member of the Development-Team — No Support via PM
- Registered User
- Posts: 428
- Joined: Fri Apr 23, 2010 10:18 am
- 3.2 Release Manager
- Posts: 298
- Joined: Sun Apr 13, 2014 1:40 am
- Location: Paris
I would say:
/help/bbcode (in a /config/routing/help.yml file ^^)
- Use the feature as second namespace and maybe we will move it to an extension later, when we could manage extensions dependencies and when we will rewrite the installer (and so when it will be able to install extensions).
Member of the phpBB Development-Team
No Support via PM
- Posts: 1727
- Joined: Sun Jan 11, 2004 2:11 am
- Location: Karlsruhe, Germany
Let's keep the FAQ in core rather than an extension. I also agree that it should be phpbb/help/controller/faq.php, so we keep it somewhat a separate subsystem. The URLs you suggested sound good.
- Registered User
- Posts: 103
- Joined: Wed May 04, 2011 7:47 pm
- Location: グリーン ヒル ゾーン
Every page that is not searchable is quite useless - "normal" people using the keyword search might get what they want if not only posts would be returned as results. Likewise the FAQ is visited rarely. Even the whole ACP suffers from not being searchable, which both affects rookies and experts (3.0.x: Search in ACP