Home » Setup Guide weaverFM

Setup Guide


The set up guide details how to accomplish the following tasks in weaverFM:


  • Create the data directory
  • Set the proper permissions for the data directory
  • Set php.ini configuration values to increate the max upload size.


You will need the following items to get started:


  • A FTP client. These screenshots use Transmit as an FTP application, however, any FTP application you are comfortable with will work.
  • A text editor. These screenshots use TextWrangler as a text editor. TextEdit and Microsoft Word is NOT recommended.


Creating the data directory


The data directory is the folder where all of the file uploads will be placed. When PHP is unable to create this directory, an error similar to Figure 1 is displayed.


To fix this you will have to FTP into your host, navigate to the same folder as the page's php script lives, and create a data folder. For this exercise let's assume the following:


  1. The page exported was called page42.php
  2. In your browser you would view this page by going to mysite.com/filemanager/page42.php.


Therefore you should:


  1. Connect to your host via FTP.
  2. Navigate to the filemanager/ folder. In this folder you will see a page42.php file and (typically) a files/ folder.
  3. Now create a new folder and call it "data" (no quotes). Figure 2 shows a weaverFM page with a new data folder.


Setting Folder Permissions


Once you have created the data directory, you will need to set the folder permissions to allow PHP write access. To do this simply 'Get Info' on the folder, set the permissions to 777, and hit 'Apply'. Figure 3 shows the Info window for the data folder in Figure 2.


Increasing the Max Upload Size


As of version 1.1.0, weaverFM can automatically generate a PHP.ini file. This preference is available within the General Preferences. The recommended method, however, to increase the max upload size for files is to manually edit your host's PHP.ini file. How to do this varies from host to host. It is highly recommended that you contact your host for specific instructions.


Note that there are TWO seperate values in the PHP.ini file that you will need to modify, upload_max_filesize and post_max_size. WeaverFM will automatically use the SMALLER of these two values. Therefore, it is important to set BOTH to the desired value.


Here are some recommended resources and tips on setting values in your PHP.ini file:


  • Drupal covers the PHP values to set and the proper syntax used in a PHP.ini file. http://drupal.org/node/97193
  • Godaddy requires that the PHP.ini file be called php5.ini and placed in your document root.
  • Please post tips, guides, and other resources for your configuring PHP.ini on my Google Group.



mkdir.png

Figure 1. PHP mkdir() error.



data.png


Figure 2. Creating the data folder for weaverFM.



permissions.png

Figure 3. Creating the data folder for weaverFM.