___________________
___________________
______
DESCRIPTION
The attached tool, called Fix Permissions, is a standalone script (not a module) which, when placed and accessed in your home directory for your website, will reset the permissions for all WebsiteBaker related directories to the correct settings. See the following link for details on what these permissions should be.
http://www.websitebaker2.org/forum/index.php/topic,18526.msg123505.html#msg123505Note: Incorrectly set permissions can be the hidden cause behind many issues with your website, from not being able to create or modify a new page to being unable to upload files, modules, templates and languages.
FYI: If you can't see the attachment, it's probably because you are not logged in.
___________________
___________________
_____
CONFIGURATION
Fix Permissions will work as is. However, should you want to configure it for a specific purpose, there are some settings you can change.
Usiing a text editor to edit the file, you can configure three things:
- The list of files
- The permissions
- Whether you want to apply the settings only to WebsiteBaker files or all files.
The settings are located near the top of the file.
___________________
___________________
______
INSTALLATION
Download the latest version of this tool by going to:
http://www.websitebakers.com/pages/tools/fix-permissions.phpUse FTP to upload the PHP file to the home directory of your website. Additional information will be displayed when you first access the script through your browser.
___________________
___________________
______
USAGE
Always be sure to test the PHP script out on a non-production system before you decide to trust it with your production site. There is NO UNDO feature. It is generally a good idea to have a working backup of your site before you run this script. Note that it does not touch the database in any way.
To run the script, simply access the file using your web browser. For example,
www.yoursite.com/fix_permissions.phpYou will be presented with two options:
- Apply the changes
- Preview the changes
The
Preview screen will also give you the option to
Apply the changes.
IMPORTANT: Be sure to remove this file from your server when you are done.___________________
___________________
_____
CREDITS
WebsiteBaker Fix Permissions - by Michael Milette (
www.TNGConsulting.c a)
v0.2 - Added Preview option (2010-09-13)
v0.1 - Initial release (2010-09-11)
WebsiteBaker Fix Permissions (fix-permissions.php) by Michael Milette - TNG Consulting Inc. is licensed under the Creative Commons Attribution-ShareAlike 2.5 Canada License. To view a copy of this licence, visit
http://creativecommons.org/licenses/by-sa/2.5/ca/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California 94105, USA. Permissions beyond the scope of this license may be available by contacting the author at
www.tngconsulting.c a.
Thanks also go to erpe for his design of the common look and feel for third party applications which he developed in his WebsiteBaker Precheck (check-wb) project.
___________________
___________________
_____
TROUBLESHOOTING
Although I have gone though a fair amount of testing both on Linux and Windows, just because the script worked for me doesn't mean it will work for you.
The requirements are:
- An installed version of WebsiteBaker 2.7 to 2.8.1
- Being comfortable editing PHP source code (if you want to customize it).
Note that, although it will run, this script doesn't appear to have any effect when running on Windows.
Should something go wrong with the script, you could loose access to your files on the server. Should this happen, a good strategy is to attempt to reset the permissions using the web-based file manager provided to you by your hosting provider. It can often be found, for example, in your cPanel or similar application. This application may have additional rights that you don't have when accessing the files through FTP or even a PHP script. The only alternative may be to to contact your hosting provider for assistance.
Other than that, it's simple and pretty straight forward. Be sure to also check out the Check-WB tool at:
http://www.websitebakers.com/pages/tools/check-wb.phpHope this helps!
With warmest regards,
Michael Milette