Over the years, people have posted questions, commented and sought help with the FPA tool. In my opinion, I think it's unfortunate that these people only have one or two topics in which to place their comments. I suggest that we have a whole forum category for these things.

The FPA tool is Joomla version-agnostic; that is to say, the FPA tool can be used with J! 1.5, J! 1.6, J! 1.7, J! 2.5, J! 3.x and J! 4. Further, the FPA tool can be used on websites that don't even have Joomla installed (not that it may be useful but it still can be used if people want to do that kind of thing).

In addition, the FPA tool is not specifically forum category-dependent; that is to say, the tool isn't just for "security" issues (whether we're talking about J! 2.5 or any other version of Joomla). The FPA tool can be used to diagnose/analyse any number of things, from installation problems, migration, templating, extension matters, etc.

I think it will help if we have a dedicated forum category for discussing general FPA matters. I can't see why it would hurt to have a new category for them.

I realise that it takes time for questions like this one to receive attention so I'm asking (patiently) for someone to read this topic and consider the request. Thank you in anticipation of a favourable response.

1) Every day, when I visit the forum and see other charitable members of the community suggest to newcomers that it would be in their interests to use the Forum Post Assistant tool, continual reference is made to viewtopic.php?f=714&t=793531 (also note that this topic was created as a "sticky" in the Security in J! 3.x forum category).

Has anyone actually read this and tried to follow what it's saying? I could well understand the reaction is TL;DR.

The usual response (when people write "viewtopic.php?f=714&t=793531 please" is for the respondant to post images or the FPA BBcode as an attachment. This is often followed by a "Please follow the instructions" post.

2) We're asking newcomers to the forum to play link-leapfrog-to-nowhere by firstly telling people to go to one topic, that refers to a second topic, that results in people still getting confused and posting the FPA report in an usuable way. Furthermore, when people read the first topic (that points to the second topic) some people think that they're supposed to use the second topic as the place to post the FPA output!

3) The key words in the FPA topic(s) are

Forum Post Assistant wrote: ↑Detailed instructions for installation and usage are ... [included as a PDF file] in the downloaded package.

Most of the other "detailed instructions" (while they are factually correct, for the most part) are unnecessary and extremely confusing to follow.

So, while I appreciate the forum management team pausing to think about this matter, life goes on and newcomers to the forum continue to be confronted with a barrage of difficult-to-follow "instructions".

Thank you for your reply. I'm asking that there is be one simple and easy-to-follow sticky topic that applies to all forum categories (at the moment there are several) and that "discussions" (such as they may be required) on how to use the FPA and problems that people seem to have with it are located within a forum category for that purpose.

The sticky topic shouldn't require discussion.

The instructions for use seem to be too complicated for the average user. I think we can simplify the instructions down to a paragraph or two.

Please read again my earlier posts that explain the current difficulties.

@Webdongle: yes, there is an easier way to explain how to use the FPA. I can write a simple explanation of how to use it (give me 5 or 10 minutes to come up with a first draft which I'll post here). The point that I'm trying to make is that when someone writes "viewtopic.php?f=714&t=793531 please" have you looked at what they're being asked to do?

I know that I love to write long forum post when I probably should just cut to the chase and be concise to the point of being taciturn.

The Forum Post Assistant (FPA) script has been developed to assist assist people to self-assess their websites. It is also used to provide basic information about the website environment as a pre-formatted forum post for troubleshooting purposes. This can save many hours of posting back and forth, asking for (and explaining how to obtain) relevant information in order for other forum users to help with problems. The process also means that information is gathered and presented in a consistent manner enabling helpers to quickly target information relevant to the specific problem observed by the user.

Detailed Instructions:
For first time users, extract the file FPA First Time User.pdf from the /Documentation folder in that file. The instructions are contained in the PDF document.

Disclaimer:USE AT YOUR OWN RISK
Accuracy and completeness of this script and documentation is not assured and no responsibility will be accepted for any damage, issues or confusion caused by using any FPA versions contained within these branches.

After use:Please remove the FPA script from your website or otherwise change the filename name after you have used it. This is so outsiders can't take misuse the script to examine the site structure and possibly exploit any weaknesses that may be present.

Last edited by sozzled on Sun Dec 09, 2018 1:09 am, edited 4 times in total.

Uuuuuuuuummmmmmmmmmm yes but (there is always a but). The detail pdf will be just as lengthy and added to the fact that they have to click to read it elsewhere.
Perhaps
1. Download
2. Unzip
3. Upload fpa-en.php to the root of the site
4. Point your browser at yoursite.com/fpa-en.php
5. Follow the on-screen instructions

The problem is that newbies often don't know how to Unzip, upload or know what the root of the site is.

No. The "simple" text instructions you've written (e.g. "Follow the on-screen instructions") are ignored or even those instructions are too fpdiificult to follow. Basically, my amended text is straightforward and will require little or no change for a long time.

The instructions in the PDF are really good.

I don't believe that novices don't know how to unzip. If they have to unzip to read the manual then they're halfway there.

Anyway, we're debating detail. The current sticky post instructions are too complicated. The current sticky post contains information that's unnecessary. The current sticky post doesn't get straight to the point. The current sticky post is confusing and tells people to read another sticky post to in order to figure out how to use the FPA.

Does anyone agree with me that the sticky post (viewtopic.php?f=714&t=793531) is not working for us? If no-one agrees with me on this fundamental issue then the other ideas (e.g. "adding pictures to the .ZIP" or "following the on-screen discussions" is pretty much making an already bad situation no better, IMO.

There are two points I'm trying to make: the sticky post in its present form (actually there are threedifferent stickies, depending on which forum category you're looking at) is not working for us;(the second point is to ask for a forum sub-category where people can discuss the FPA).

I do see the point but you are making but what you suggest are not instructions. My list (of instructions) were 'tounge in cheek' to point out the futility of trying to simplify the instructions. Hopefully when the next generation of the fpa is complete then things will be easier ... but until then it looks like we have manage with the current instructions.

I think that the current instructions are sometimes off-putting but your suggestion is not a set of instructions. I think that trying to simplify the instructions (for the current version of the fpa) is futile. And Hopefully when the next generation of the fpa is complete then things will be easier ... but until then it looks like we have manage with the current instructions.

Do you mean that you agree with me (that the three different sticky posts are not working for us)? Leave aside for the moment what else I have suggested. This is the core question.

As far as the "next generation of the FPA" is concerned, we both know that this several months away. The implied follow up question is what should we do to alleviate the confusion (and the distress it causes) with the current instructions.

I would like to know your thoughts in relation to the core question. Do you agree with me?

I agree 3 sticky posts are not the best and should have its own forum.
I agree that the instructions appear to make some newbies faint at the thought.
But I disagree that your suggestion for simplifying will work.

I notice that some people still continue to advise novice users to "viewtopic.php?f=714&t=793531 please". As we have seen, this advice does not work and confuses novice users.

I've also noticed that @toivo and a couple of others are now writing

Download FPA from viewtopic.php?f=714&t=793531. Expand the file, locate the Documentation folder and follow the instructions in the user guide 'FPA First Time User.pdf'.

This is much clearer and more helpful.

I would like to see a new sticky topic created (in a forum category devoted FPA-related matters) along the lines I recommended earlier (viewtopic.php?f=7&t=966324#p3550995). Even though @Webdongle thinks my draft is "wrong", and didn't propose anything more "right", I have been using this reference in many topics recently and it's been almost 100% effective.

The matter—the confusion with having several topics sprinkled around in different parts of the whole forum—with information that's complicated or, in some cases, causes alarm and fear among novice users, is not resolved. I had hoped that this topic may have encouraged more interaction from the forum moderator team. I'm a little disappointed that there hasn't yet been any improvement in the overall situation.

I agree, in general, with @Webdongle's ideas that a separate category—placed either before or somewhere after the "support" categories—would be the way to go. To extend beyond his suggestion, the new Forum Post Assistant forum could look like this:

fpaForum_design.png

Within this new forum category there would be one sticky post. I still recommend the wording I used earlier (viewtopic.php?f=7&p=3557479#p3550995) and for the reasons that I've gone into length to explain here and elsewhere.

This new forum category would allow all members of the community to (a) obtain information about how to use the FPA, (b) discuss issues/problems/concerns that they have with the FPA, and (c) allow the FPA development group to test and discuss changes to the FPA tool(s).

It may be a case of add the new forum, place it before the "support" categories (as @Webdongle suggested) and see if it discourages people using the "support" categories, or place it after the "support" categories and see if the placement discourages people using the FPA tool (or using it properly). I can't say where we should place the new FPA forum category; that's a "market research" question.

You do not have the required permissions to view the files attached to this post.

I don't want to prolong the torture. This discussion been ineffectual for four months (probably because of differences of personal opinion). My preference is for a locked sticky post contained within an open forum category. I can't see the benefit of having discussions within a sub-forum but that's just a personal view and we can debate the merits or demerits after the forum category has been created.

The main sticking point (from the board managers) has been about the necessity the forum category (as we have advocated since October last year). The other sticking point (within the broader community) has been about the choice of words, images (or videos, even) to promote what the FPA is about. I can't do anything about the first-mentioned of these two sticking points; it's not within my power to undertake that activity. As far as the form that the new the sticky post will take, only time will tell.