Help on PHPBB/Forum Software

Propose new features and changes
User avatar
hoppfrosch
Posts: 394
Joined: 07 Oct 2013, 04:05
GitHub: hoppfrosch
Location: Rhine-Maine-Area, Hesse, Germany
Contact:

Help on PHPBB/Forum Software

17 Oct 2013, 05:25

Wouldn't it make sense to offer a static page, providing some basic help on "Howto use PHPBB and currently installed PHPBB-Addons to write a well formated forum entry"?

The current WYSIWYG-editor does
  • not offer all currently provided available formatting styles (for example strikethrough)
  • not support all features a certain tag could have
    For example selecting a word and clicking a word does simply exand to

    Code: Select all

    [url]word[/url]
    The possibilty of using a "=" within code-tag is not shown. Best would be, if the WYSIWYG editor would expand to

    Code: Select all

    [url=word]word[/url]
  • It's not obvious, which parameters some of the available tags need: Does the gist-tag need the gist-id or the gist-url? ....
  • ....
This page might also be used as a reference, when you feel the need to tell a user "Use code tags!"....
Alibaba
Posts: 479
Joined: 29 Sep 2013, 16:15
Location: Germany

Re: Help on PHPBB/Forum Software

17 Oct 2013, 05:46

I agree, it would be nice for new users to get little help with phpBB forum usage.
"Nothing is quieter than a loaded gun." - Heinrich Heine
User avatar
tank
Posts: 2823
Joined: 28 Sep 2013, 22:15
Facebook: charlie.simmons.7334
Google: ttnnkkrr
GitHub: ttnnkkrr
Location: Irving TX
Contact:

Re: Help on PHPBB/Forum Software

17 Oct 2013, 08:08

If someone wants to write such a page I will post it
We are troubled on every side‚ yet not distressed; we are perplexed‚
but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
https://www.facebook.com/ahkscript.org
If you have forum suggestions please submit a pull request
Check Out WebWriter
Thanks Tank :thumbup:
User avatar
sinkfaze
Posts: 614
Joined: 01 Oct 2013, 08:01

Re: Help on PHPBB/Forum Software

17 Oct 2013, 08:10

hoppfrosch wrote:Wouldn't it make sense to offer a static page, providing some basic help on "Howto use PHPBB and currently installed PHPBB-Addons to write a well formated forum entry"?
Isn't there already a page for that?
User avatar
hoppfrosch
Posts: 394
Joined: 07 Oct 2013, 04:05
GitHub: hoppfrosch
Location: Rhine-Maine-Area, Hesse, Germany
Contact:

Re: Help on PHPBB/Forum Software

17 Oct 2013, 10:12

sinkfaze wrote:Isn't there already a page for that?
Yes - that's nearly exactly what I meant. Haven't seen this page before - it seems not to be linked on forum pages. The "FAQ"-Link on the top of the current page leads to different page

Would be nice if the mentioned page would have more advanced entries as I suggested above.
tank wrote:If someone wants to write such a page I will post it
If there would be the possibility to contribute to the mentioned page , I'll probably contribute to it (despite my not very good english) ...
Last edited by hoppfrosch on 17 Oct 2013, 10:14, edited 1 time in total.
User avatar
tank
Posts: 2823
Joined: 28 Sep 2013, 22:15
Facebook: charlie.simmons.7334
Google: ttnnkkrr
GitHub: ttnnkkrr
Location: Irving TX
Contact:

Re: Help on PHPBB/Forum Software

17 Oct 2013, 10:14

might not hurt to make the link a little more prominent i suppose maybe next to the buttons and the link could read [More about BBCODE]


And i would welcome translations or edits just submit them to me via this thread
We are troubled on every side‚ yet not distressed; we are perplexed‚
but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
https://www.facebook.com/ahkscript.org
If you have forum suggestions please submit a pull request
Check Out WebWriter
Thanks Tank :thumbup:
User avatar
hoppfrosch
Posts: 394
Joined: 07 Oct 2013, 04:05
GitHub: hoppfrosch
Location: Rhine-Maine-Area, Hesse, Germany
Contact:

Re: Help on PHPBB/Forum Software

17 Oct 2013, 10:20

tank wrote:might not hurt to make the link a little more prominent i suppose maybe next to the buttons and the link could read [More about BBCODE]

And i would welcome translations or edits just submit them to me via this thread
I would suggest a different title instead of "More about BBCode" - sounds to technical in my ears. Alternative: "Formatting posts" or something like this ...

In which "language" the contributions should be written? PLAIN Text? HTML? Markdown? BBCode? Wouldn't it make sense to have more trusted people directly editing this page? (just to get some work load from your shoulders)
User avatar
tank
Posts: 2823
Joined: 28 Sep 2013, 22:15
Facebook: charlie.simmons.7334
Google: ttnnkkrr
GitHub: ttnnkkrr
Location: Irving TX
Contact:

Re: Help on PHPBB/Forum Software

17 Oct 2013, 10:26

exactly we have to ensure we are catering to novices even if it sometimes seems rediculous. i like "formatting posts with bbcode"
We are troubled on every side‚ yet not distressed; we are perplexed‚
but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
https://www.facebook.com/ahkscript.org
If you have forum suggestions please submit a pull request
Check Out WebWriter
Thanks Tank :thumbup:
User avatar
hoppfrosch
Posts: 394
Joined: 07 Oct 2013, 04:05
GitHub: hoppfrosch
Location: Rhine-Maine-Area, Hesse, Germany
Contact:

Re: Help on PHPBB/Forum Software

17 Oct 2013, 11:44

tank wrote:exactly we have to ensure we are catering to novices even if it sometimes seems rediculous. i like "formatting posts with bbcode"
I would omit "with bbcode" as this might imply, that this a "special way" formatting posts. Is there any other was, to format posts beside plain text or BBCode?

In which "language" the contributions to the mentioned page should be written? PLAIN Text? HTML? Markdown? BBCode? Wouldn't it make sense to have more trusted people directly editing this page? (just to get some work load from your shoulders)
User avatar
tank
Posts: 2823
Joined: 28 Sep 2013, 22:15
Facebook: charlie.simmons.7334
Google: ttnnkkrr
GitHub: ttnnkkrr
Location: Irving TX
Contact:

Re: Help on PHPBB/Forum Software

17 Oct 2013, 12:46

i welcome as much help as possible
I like phpbb but there are things they do like this that make me scratch my frakkin head

Code: Select all

<?php
/**
* \boards\language\en\help_bbcode.php
* help_bbcode [English]
*
* @package language
* @version $Id$
* @copyright (c) 2005 phpBB Group
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
*
*/

/**
*/
if (!defined('IN_PHPBB'))
{
	exit;
}

// DEVELOPERS PLEASE NOTE
//
// All language files should use UTF-8 as their encoding and the files must not contain a BOM.
//
// Placeholders can now contain order information, e.g. instead of
// 'Page %s of %s' you can (and should) write 'Page %1$s of %2$s', this allows
// translators to re-order the output of data while ensuring it remains correct
//
// You do not need this where single placeholders are used, e.g. 'Message %d' is fine
// equally where a string contains only two placeholders which are used to wrap text
// in a url you again do not need to specify an order e.g., 'Click %sHERE%s' is fine

$help = array(
	array(
		0 => '--',
		1 => 'Introduction'
	),
	array(
		0 => 'What is BBCode?',
		1 => 'BBCode is a special implementation of HTML. Whether you can actually use BBCode in your posts on the forum is determined by the administrator. In addition you can disable BBCode on a per post basis via the posting form. BBCode itself is similar in style to HTML, tags are enclosed in square brackets [ and ] rather than < and > and it offers greater control over what and how something is displayed. Depending on the template you are using you may find adding BBCode to your posts is made much easier through a clickable interface above the message area on the posting form. Even with this you may find the following guide useful.'
	),
	array(
		0 => '--',
		1 => 'Text Formatting'
	),
	array(
		0 => 'How to create bold, italic and underlined text',
		1 => 'BBCode includes tags to allow you to quickly change the basic style of your text. This is achieved in the following ways: <ul><li>To make a piece of text bold enclose it in <strong>[b][/b]</strong>, e.g. <br /><br /><strong>[b]</strong>Hello<strong>[/b]</strong><br /><br />will become <strong>Hello</strong></li><li>For underlining use <strong>[u][/u]</strong>, for example:<br /><br /><strong>[u]</strong>Good Morning<strong>[/u]</strong><br /><br />becomes <span style="text-decoration: underline">Good Morning</span></li><li>To italicise text use <strong>[i][/i]</strong>, e.g.<br /><br />This is <strong>[i]</strong>Great!<strong>[/i]</strong><br /><br />would give This is <i>Great!</i></li></ul>'
	),
	array(
		0 => 'How to change the text colour or size',
		1 => 'To alter the colour or size of your text the following tags can be used. Keep in mind that how the output appears will depend on the viewers browser and system: <ul><li>Changing the colour of text is achieved by wrapping it in <strong>[color=][/color]</strong>. You can specify either a recognised colour name (eg. red, blue, yellow, etc.) or the hexadecimal triplet alternative, e.g. #FFFFFF, #000000. For example, to create red text you could use:<br /><br /><strong>[color=red]</strong>Hello!<strong>[/color]</strong><br /><br />or<br /><br /><strong>[color=#FF0000]</strong>Hello!<strong>[/color]</strong><br /><br />Both will output <span style="color:red">Hello!</span></li><li>Changing the text size is achieved in a similar way using <strong>[size=][/size]</strong>. This tag is dependent on the template the user has selected but the recommended format is a numerical value representing the text size in percent, starting at 20 (very small) through to 200 (very large) by default. For example:<br /><br /><strong>[size=30]</strong>SMALL<strong>[/size]</strong><br /><br />will generally be <span style="font-size:30%;">SMALL</span><br /><br />whereas:<br /><br /><strong>[size=200]</strong>HUGE!<strong>[/size]</strong><br /><br />will be <span style="font-size:200%;">HUGE!</span></li></ul>'
	),
	array(
		0 => 'Can I combine formatting tags?',
		1 => 'Yes, of course you can, for example to get someones attention you may write:<br /><br /><strong>[size=200][color=red][b]</strong>LOOK AT ME!<strong>[/b][/color][/size]</strong><br /><br />this would output <span style="color:red;font-size:200%;"><strong>LOOK AT ME!</strong></span><br /><br />We don’t recommend you output lots of text that looks like this though! Remember it is up to you, the poster, to ensure tags are closed correctly. For example the following is incorrect:<br /><br /><strong>[b][u]</strong>This is wrong<strong>[/b][/u]</strong>'
	),
	array(
		0 => '--',
		1 => 'Quoting and outputting fixed-width text'
	),
	array(
		0 => 'Quoting text in replies',
		1 => 'There are two ways you can quote text, with a reference or without.<ul><li>When you utilise the Quote function to reply to a post on the board you should notice that the post text is added to the message window enclosed in a <strong>[quote=""][/quote]</strong> block. This method allows you to quote with a reference to a person or whatever else you choose to put! For example to quote a piece of text Mr. Blobby wrote you would enter:<br /><br /><strong>[quote="Mr. Blobby"]</strong>The text Mr. Blobby wrote would go here<strong>[/quote]</strong><br /><br />The resulting output will automatically add "Mr. Blobby wrote:" before the actual text. Remember you <strong>must</strong> include the quotation marks "" around the name you are quoting, they are not optional.</li><li>The second method allows you to blindly quote something. To utilise this enclose the text in <strong>[quote][/quote]</strong> tags. When you view the message it will simply show the text within a quotation block.</li></ul>'
	),
	array(
		0 => 'Outputting code or fixed width data',
		1 => 'If you want to output a piece of code or in fact anything that requires a fixed width, e.g. Courier type font you should enclose the text in <strong>[code]
</strong> tags, e.g.<br /><br /><strong>

Code: Select all

</strong>echo "This is some code";<strong>
</strong><br /><br />All formatting used within <strong></strong> tags is retained when you later view it. PHP syntax highlighting can be enabled using <strong></strong> and is recommended when posting PHP code samples as it improves readability.'
),
array(
0 => '--',
1 => 'Generating lists'
),
array(
0 => 'Creating an Unordered list',
1 => 'BBCode supports two types of lists, unordered and ordered. They are essentially the same as their HTML equivalents. An unordered list outputs each item in your list sequentially one after the other indenting each with a bullet character. To create an unordered list you use <strong>
    </strong> and define each item within the list using <strong>[*]</strong>. For example to list your favourite colours you could use:<br /><br /><strong>
    • </strong><br /><strong>
    • </strong>Red<br /><strong>
    • </strong>Blue<br /><strong>
    • </strong>Yellow<br /><strong>
    </strong><br /><br />This would generate the following list:<ul><li>Red</li><li>Blue</li><li>Yellow</li></ul>'
    ),
    array(
    0 => 'Creating an Ordered list',
    1 => 'The second type of list, an ordered list, gives you control over what is output before each item. To create an ordered list you use <strong>
      </strong> to create a numbered list or alternatively <strong>
        </strong> for an alphabetical list. As with the unordered list, items are specified using <strong>[*]</strong>. For example:<br /><br /><strong>
        1. </strong><br /><strong>
        2. </strong>Go to the shops<br /><strong>
        3. </strong>Buy a new computer<br /><strong>
        4. </strong>Swear at computer when it crashes<br /><strong>
        </strong><br /><br />will generate the following:<ol style="list-style-type: decimal;"><li>Go to the shops</li><li>Buy a new computer</li><li>Swear at computer when it crashes</li></ol>Whereas for an alphabetical list you would use:<br /><br /><strong>
        1. </strong><br /><strong>
        2. </strong>The first possible answer<br /><strong>
        3. </strong>The second possible answer<br /><strong>
        4. </strong>The third possible answer<br /><strong>
        </strong><br /><br />giving<ol style="list-style-type: lower-alpha"><li>The first possible answer</li><li>The second possible answer</li><li>The third possible answer</li></ol>'
        ),
        // This block will switch the FAQ-Questions to the second template column
        array(
        0 => '--',
        1 => '--'
        ),
        array(
        0 => '--',
        1 => 'Creating Links'
        ),
        array(
        0 => 'Linking to another site',
        1 => 'phpBB BBCode supports a number of ways of creating URIs (Uniform Resource Indicators) better known as URLs.<ul><li>The first of these uses the <strong></strong> tag, whatever you type after the = sign will cause the contents of that tag to act as a URL. For example to link to phpBB.com you could use:<br /><br /><strong></strong>Visit phpBB!<strong></strong><br /><br />This would generate the following link, <a href="http://www.phpbb.com/">Visit phpBB!</a> Please notice that the link opens in the same window or a new window depending on the users browser preferences.</li><li>If you want the URL itself displayed as the link you can do this by simply using:<br /><br /><strong></strong>http://www.phpbb.com/<strong></strong><br /><br />This would generate the following link, <a href="http://www.phpbb.com/">http://www.phpbb ... ditionally, phpBB features something called <i>Magic Links</i>, this will turn any syntactically correct URL into a link without you needing to specify any tags or even the leading http://. For example typing www.phpbb.com into your message will automatically lead to <a href="http://www.phpbb.com/">www.phpbb.com</a> being output when you view the message.</li><li>The same thing applies equally to e-mail addresses, you can either specify an address explicitly for example:<br /><br /><strong>[email]</strong>[email protected]<strong>[/email]</strong><br /><br />which will output <a href="mailto:[email protected]">[email protected]</a> or you can just type [email protected] into your message and it will be automatically converted when you view.</li></ul>As with all the BBCode tags you can wrap URLs around any of the other tags such as <strong>[img][/img]</strong> (see next entry), <strong></strong>, etc. As with the formatting tags it is up to you to ensure the correct open and close order is following, for example:<br /><br /><strong>[img]</strong>http://www.google.com/intl/en_ALL/image ... gif<strong>[/img]</strong><br /><br />is <span style="text-decoration: underline">not</span> correct which may lead to your post being deleted so take care.'
        ),
        array(
        0 => '--',
        1 => 'Showing images in posts'
        ),
        array(
        0 => 'Adding an image to a post',
        1 => 'phpBB BBCode incorporates a tag for including images in your posts. Two very important things to remember when using this tag are: many users do not appreciate lots of images being shown in posts and secondly the image you display must already be available on the internet (it cannot exist only on your computer for example, unless you run a webserver!). To display an image you must surround the URL pointing to the image with <strong>[img][/img]</strong> tags. For example:<br /><br /><strong>[img]</strong>http://www.google.com/intl/en_ALL/image ... gif<strong>[/img]</strong><br /><br />As noted in the URL section above you can wrap an image in a <strong></strong> tag if you wish, e.g.<br /><br /><strong>[img]</strong>http://www.google.com/intl/en_ALL/image ... gif<strong>[/img]</strong><br /><br />would generate:<br /><br /><a href="http://www.google.com/"><img src="http://www.google.com/intl/en_ALL/images/logo.gif" alt="" /></a>'
        ),
        array(
        0 => 'Adding attachments into a post',
        1 => 'Attachments can now be placed in any part of a post by using the new <strong>[attachment=][/attachment]</strong> BBCode, if the attachments functionality has been enabled by a board administrator and if you are given the appropriate permissions to create attachments. Within the posting screen is a drop-down box (respectively a button) for placing attachments inline.'
        ),
        array(
        0 => '--',
        1 => 'Other matters'
        ),
        array(
        0 => 'Can I add my own tags?',
        1 => 'If you are an administrator on this board and have the proper permissions, you can add further BBCodes through the Custom BBCodes section.'
        )
        );

        ?>[/code]post your changes back and ill be happy to use them
        or you can copy the page as html and i can plug the changes in
        We are troubled on every side‚ yet not distressed; we are perplexed‚
        but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
        https://www.facebook.com/ahkscript.org
        If you have forum suggestions please submit a pull request
        Check Out WebWriter
        Thanks Tank :thumbup:
        User avatar
        hoppfrosch
        Posts: 394
        Joined: 07 Oct 2013, 04:05
        GitHub: hoppfrosch
        Location: Rhine-Maine-Area, Hesse, Germany
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Oct 2013, 01:36

        tank wrote:i welcome as much help as possible
        ...
        or you can copy the page as html and i can plug the changes in
        I saved the current page and generated a git-hosted gh-page from it (here you find the github-repository). You may plug the changes in by merging the original document with my documentation or by simply linking to github-page ....

        I just started with basic modifications (documented ) .... but there are a few things on the todo-list.

        Would like to have a response whether this is a way to go, before spending more time on this ...
        User avatar
        tank
        Posts: 2823
        Joined: 28 Sep 2013, 22:15
        Facebook: charlie.simmons.7334
        Google: ttnnkkrr
        GitHub: ttnnkkrr
        Location: Irving TX
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Oct 2013, 06:05

        This approach is fine I will merge. But the weekend mess with the host took all my time and I never could do the other intended updated
        We are troubled on every side‚ yet not distressed; we are perplexed‚
        but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
        https://www.facebook.com/ahkscript.org
        If you have forum suggestions please submit a pull request
        Check Out WebWriter
        Thanks Tank :thumbup:
        User avatar
        hoppfrosch
        Posts: 394
        Joined: 07 Oct 2013, 04:05
        GitHub: hoppfrosch
        Location: Rhine-Maine-Area, Hesse, Germany
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Oct 2013, 06:15

        No hurry - just wanted to be sure I'm on the right way ...
        User avatar
        tank
        Posts: 2823
        Joined: 28 Sep 2013, 22:15
        Facebook: charlie.simmons.7334
        Google: ttnnkkrr
        GitHub: ttnnkkrr
        Location: Irving TX
        Contact:

        Re: Help on PHPBB/Forum Software

        27 Oct 2013, 14:59

        I have used file_get_contents() to pull in your content
        i have added a link next to the buttons
        finally i have added a center tag and modified the strike button
        can you update the faq with the center button?
        We are troubled on every side‚ yet not distressed; we are perplexed‚
        but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
        https://www.facebook.com/ahkscript.org
        If you have forum suggestions please submit a pull request
        Check Out WebWriter
        Thanks Tank :thumbup:
        User avatar
        hoppfrosch
        Posts: 394
        Joined: 07 Oct 2013, 04:05
        GitHub: hoppfrosch
        Location: Rhine-Maine-Area, Hesse, Germany
        Contact:

        Re: Help on PHPBB/Forum Software

        28 Oct 2013, 02:14

        tank wrote:finally i have added a center tag a ...
        can you update the faq with the center button?
        Done ... new document is ready for pulling.
        Thx for incorporating, hope this workflow is OK for you.
        User avatar
        hoppfrosch
        Posts: 394
        Joined: 07 Oct 2013, 04:05
        GitHub: hoppfrosch
        Location: Rhine-Maine-Area, Hesse, Germany
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Mar 2014, 05:16

        tank wrote:i have added a link next to the buttons
        The link seems to got lost during recent forum updates ... Is there still interest in this documentation? :?:
        If yes, I would add some docu about the spoiler-tag, else I would abondon the document (I have no idea what's the current URL on ahkscript.org - you can have a look at the current customized phpBB-Help at https://github.com/hoppfrosch/AHKScript_BBCodeGuide)
        User avatar
        tank
        Posts: 2823
        Joined: 28 Sep 2013, 22:15
        Facebook: charlie.simmons.7334
        Google: ttnnkkrr
        GitHub: ttnnkkrr
        Location: Irving TX
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Mar 2014, 07:34

        Your refering to the formatting posts link?
        Its tghere for me
        Which theme do you use?
        We are troubled on every side‚ yet not distressed; we are perplexed‚
        but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
        https://www.facebook.com/ahkscript.org
        If you have forum suggestions please submit a pull request
        Check Out WebWriter
        Thanks Tank :thumbup:
        User avatar
        hoppfrosch
        Posts: 394
        Joined: 07 Oct 2013, 04:05
        GitHub: hoppfrosch
        Location: Rhine-Maine-Area, Hesse, Germany
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Mar 2014, 08:03

        2014-03-24 13_54_47-AHKScript (an AutoHotkey Forum) • Post a reply.png
        That's what I currently see within editor ...no link to "Formatting posts" - where should the link occur?
        tank wrote:Your refering to the formatting posts link?
        Its tghere for me
        Which theme do you use?
        Using theme "Prosilver"
        User avatar
        tank
        Posts: 2823
        Joined: 28 Sep 2013, 22:15
        Facebook: charlie.simmons.7334
        Google: ttnnkkrr
        GitHub: ttnnkkrr
        Location: Irving TX
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Mar 2014, 08:11

        yea i dont think i added to any but subsilver2. Ill add to prosilver this week
        We are troubled on every side‚ yet not distressed; we are perplexed‚
        but not in despair; Persecuted‚ but not forsaken; cast down‚ but not destroyed;
        https://www.facebook.com/ahkscript.org
        If you have forum suggestions please submit a pull request
        Check Out WebWriter
        Thanks Tank :thumbup:
        User avatar
        hoppfrosch
        Posts: 394
        Joined: 07 Oct 2013, 04:05
        GitHub: hoppfrosch
        Location: Rhine-Maine-Area, Hesse, Germany
        Contact:

        Re: Help on PHPBB/Forum Software

        24 Mar 2014, 09:14

        No hurry - I know where to find the help locally ;-).

        I'll update the page as soon as I find a time slot ....

        Return to “Wish List”

        Who is online

        Users browsing this forum: No registered users and 29 guests