General Information on the FPA Script:The Forum Post Assistant has been designed to assist forum posters to be able to post relevant system, instance, php and troubleshooting information directly in to a pre-formatted forum post. This should save a few hours of posting back and forth, asking for, and explaining how to acquire useful information in order for other forum users to help troubleshoot a problem.
This process also means that consistent information is gathered and presented in every case, enabling helpers to quickly target information relevant to the specific problem observed by the user.
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. Discussion topic on the FPA tool is at: viewtopic.php?f=621&t=656394 Report any issues there.Download:
Use these links to download the FPA:
Download .tar.gz version or Download the .zip version Compatibility: PHP 4.1,PHP4, 5, 6DEV MySQL 3.2 - 5.5 MySQLi from 4.1 ( @ >=PHP 4.4.9)
Joomla! Version Support: - v 1.0.x - v 1.5.x - v 1.6.x - v 1.7.x
Known Issues:FPA is not currently fully compatible with Joomla websites that have had their configuration.php file moved outside of the public_html directory.
Installation:1. Download the desired archive
2. Uncompress the downloaded package file on your own computer (using WinZip or another decompression tool).
3. READ the included README file for any special Release notes.
4.
READ the included Documentation file for detailed usage instructions.5. Upload the fpa-en.php script to your Joomla! Site Root "/" directory. This is the place you installed Joomla and may not be the main root for your server. See examples below.
6. Run the script through your browser by entering: http:// mysite.com/fpa-en.php. See examples below.
Installation Examples:Joomla! is installed in your web-root folder:
Upload the fpa-en.php script to: <your-domain-name.com>/public_html/
To run the script: http:// mysite.com/public_html/fpa-en.php
Joomla! is installed in a sub-directory named "cms":
Upload the fpa-en.php script to: <your-domain-name.com>/public_html/cms/
To run the script: http:// mysite.com/public_html/cms/fpa-en.php
Usage:When called from your browser, the Forum Post Assistant will run and display information it has gathered about your site and the server environment your site is installed on. You may use the information displayed by the FPA to assist in troubleshooting your site.
Attachment:
fpa1.jpg
Using the FPA to make a post to a Security forum topic:Click on the “
Show the Forum Post Assistant” link to open the Post Tool for generating the code you will paste into your forum post.
Attachment:
fpa6.jpg
Enter a brief description of your problem, any error messages you see, and a brief description of any actions you have taken to resolve the issue (optional). You may leave this information blank if desired, but providing what you can will usually help figure out the issue. Security options are best left at their default for posting in the forum.
Attachment:
fpa2.jpg
Select run time options detail level for the report and select the Information Privacy Level of the report (optional). You may leave this information at the defaults if desired, but providing additional information about installed extensions can usually help figure out the issue.
Attachment:
fpa3.jpg
Generating the Post:Click the “Click Here To Generate Post” button to build the post content using the information and options you selected above.
Click the “Reset” button to reset to defaults the information and options selections displayed in Figures 1 and 2.
If you get an “Out of Memory” or “Execution Time Error” when generating the post information, then select the Seeing PHP "Out of Memory" or "Execution Time" Errors? check box to temporarily increase PHP memory and execution times and try generating the post again.
Attachment:
fpa4.jpg
Copying the Generated Information:Place your computer cursor into the Post Detail box. It does not matter where within the code the cursor is.
Select All of the content by using the key combination CTRL – A to select all of the code within the box.
Copy the contents selected to your computers clipboard by using the key combination CTRL – C
Attachment:
fpa5.jpg
Inserting the information into a New Forum Posting:If you have not made a posting in the appropriate Joomla security forum for your version of Joomla about your security issue, then select take the steps below:
* Click on the “New Topic” button.
* Enter a descriptive subject for your topic. Avoid the phrase I was hacked!
* In the message body, enter any additional information you think may be helpful in assisting with the issue your having. Do Not post any direct links to infected sites, assumed nationality, hacker links or hacker names you found displaying on your site.
* Paste the information from the FPA into the message body area using the CTRL – V keyboard command. The correct forum format codes are already included in the post generation so there is no additional formatting needed of the generated code.
* If you need to add pictures for clarity, use the attachment upload section of the forum post editor to add them now.
* If you wish to preview the message before posting it, then click the “Preview” button below the message body area.
* When satisfied with your message, click the “Submit” button that is below the message body area.
Inserting the information into an Existing Forum Thread:* At the bottom of an existing forum thread there is a “Quick Reply” message body area. You may use that to post the FPA information into your existing forum thread.
* In the message body area, enter any additional information you think may be helpful in assisting with the issue your having. Do Not post any direct links to infected sites, assumed nationality, hacker links or hacker names you found displaying on your site.
* Paste the information from the FPA into the message body area using the CTRL – V keyboard command. The correct forum format codes are already included in the post generation so there is no additional formatting needed of the generated code.
* When satisfied with your message, click the “Submit” button that is below the message body area.
* If you wish to preview the message before posting it or prefer working in the full forum message editor, then click the “Full Editor” button below the message body area. Use the “Full Editor” if you need to add pictures for clarity!
Attachment:
fpa7.jpg
Discussion topic on the FPA tool is at: viewtopic.php?f=621&t=656394 Post any questions on the use of the FPA, bugs, and suggestions there.