File manager

From Splash Frog Docs

Contents 1 Overview 2 Navigating the File Manager 3 Maintaining Webpages 3.1 The WYSIWYG Editor 3.1.1 Paste From Word 3.1.2 Browsing the Server 3.1.3 Embedding Modules 3.2 Customizing the Webpage 3.2.1 Parent Webpage 3.2.2 Custom Website Template 3.2.3 Last Updated Template 3.2.4 Webpage Viewable on the Website 3.2.5 Make this Webpage the Homepage 3.2.6 Access Permissions 3.3 Customized Menu's & Side Modules for a Webpage 4 Uploading Files 5 Creating Folders 6 Moving a File, Folder, or Webpage 7 Rolling back a File or Webpage 8 Deleting a File, Folder, or Webpage 9 Working with the Trash Bin 10 Scheduled Webpages 11 Webpage Approvals 11.1 Updating a Pending Approval 11.2 Approving or Canceling an Approval 11.3 Send it Back to the Submittor

Overview

The file manager is where you will manage all of the static content of your website - webpages, folders, and all files that are uploaded to your website can be managed through here.

Navigating the File Manager

Navigating the File Manager is relatively easy. When you first go to the File Manager, you will be shown what is available to you at the root (or base) directory of your website. If you have any folders available to you, then you will see them in both the left folder tree and also with the current listing of files and folders. You will also be able to know what folder's content you are looking at by the "Currently In" directory path at the top of the File Manager table.

Note: If there are any files or folders that you do not have access permissions to, you will not see them displayed.

To go to another folder and view its contents, you simply click on the folder name in the left folder tree. Also, if you have folders within folders, you will see a + sign next to the folder name. You can click that + sign to expand that folder's sub-folders, and you can go directly into that sub folder without have to first go to the top level folder. On the far left you will see the option to:

• Add a Webpage
• Upload a File (If you have administrative permissions)
• Add a Folder

If you have any administrative privilages (Such as being able to publish or approve webpages) you will also see:

• View Trash Bin
• View Scheduled Webpages
• View Pending Approvals

Within the current listing of the files and folders of the directory you are looking in, you have the menu option next to each item so you can edit, delete (If you have administrative permissions), rename, rollback, quickly change access permissions, view history, or view the live file or webpage on the website. (Note: that some of these options are not available for folders, such as edit and rollback.) Also you will see two other columns to the right of the names of each item. The first column will display a clock symbol if that item has a pending scheduled task to perform (See Scheduled Webpages), and the second column will display an approval symbol if that page has any pending approvals (See Webpage Approvals).

Maintaining Webpages

Maintaining a webpage is relatively easy. Click on "Add a Webpage" to create a new webpage or hover over the menu icon of the webpage you want to update and select the "Update Webpage". (Note: When you click the "Add a Webpage", you will create a webpage within the directory that you are currently viewing in.)

Fill out the webpage name (The page name can only be alpha-numeric, and no spaces. If you try to add in any special characters the system will remove them. If you try to add in any spaces they will be replaced with an '_'.), and make sure that it is a unique page name. You cannot have two webpages be the same name in the same directory. The system will automatically check and notify you if the page name that you typed in is already in use or not. Type in a Webpage Title to title your page, and then within the online WYSIWYG Editor begin typing in your content.

Once you have everything set within the form, depending on your administrative level and permissions you will be able to either:

• Publish the webpage now
• Schedule the webpage to be published later
• Send the webpage to your approving administrative group

The WYSIWYG Editor

Splash Frog utilizes the CK Editor to manage and edit the HTML content of the webpage, so you do not need to know any HTML coding to modify your webpage content. You can however see the HTML code if you want by simply clicking the "Source" button. With the Editor you have many standard functions available to you to format the content of your webpage, such as Bold, Italic, Underline, creating a Hyperlink or a Mail Link, inserting an Image or Flash, Ordering and much more.

Below are a few of the special functions built with the Editor.

Paste From Word

One handy feature of the CK Editor is the "Paste From Word" (It is the clipboard with the Microsoft Word logo on top of it). Since Microsoft Word likes to embed extraneous and non-standardized HTML code into their documents, doing a direct copy / paste from Microsoft Word would tend to make your webpages not display properly. By utilizing the "Paste From Word", you can copy the contents from a Microsoft Word document, click the "Paste From Word" button, and paste the contents into the pop-up box that will show up. Then click "Ok". The Editor will then go through your pasted information and strip out as much as it can the extraneous Microsoft Word code, usually getting on average 95% of the code out of there, making your webpage content clean and HTML standardized.

Browsing the Server

Another aspect of the Editor is being able to browse your server to select other webpages, images, or other documents to link or embed into your webpage. When you click on the Image button or the Hyperlink button, a pop-up will appear. Next to (or underneath) the field "URL" you will see a button called "Browse Server". By clicking the button another pop-up will appear, displaying all of the available content on your server that you have access to. To select a webpage or file, simply click on the name of that file. To go into a folder, click on the folder name, and the contents of that folder will then be displayed for you. You can utilize the directory path at the top to go backwards in the folder structure if you need to. Once you have selected the file you want, it will automatically populate the URL field for you, giving you the correct path to the file you selected.

Note: Once you have saved and published that link, you will need to go back and update it if you do any of the following:

• Change a folder name leading to that file.
• Change the name of the file itself.
• Change the extension of the file.
• Move the file from its location into another.

Embedding Modules

One of the useful tools about Splash Frog and the Editor is that you can embed certain parts of a Module into the webpage. Why is this convenient? Say for example you have a blog module installed on your website, and you want to have it on a certain section of the website. You could give out the direct URL to people to access the blog module (Example: index.php?modi=123&sec=latest&view=20) OR, you can embed the module into a webpage and just give people the URL to that webpage (Example: my_blog.html).

To Embed a module, first click the icon at the far right on the 2nd row (looking like an application window with a lightning bolt on top of it). A pop up will appear listing out all the available modules you have at your disposal. Click on the module you want and it will begin taking you through different sections available to you that you can embed into your webpage. (Note: Each module will be different depending on what the module is for and how it was written, however the process should only be a few clicks to go through.) Once you have clicked on the part of the module you want to embed, the Editor will insert the proper embedding code where you last left your cursor within the editor.

Warning: Do NOT modify the inserted code, as it will cause the module to not load correctly or at all!!

Save and publish the webpage, and now that part of the module will then be shown at the spot where the embedded code was placed on that webpage!

Customizing the Webpage

Below the Webpage Content Editor, you will find some additional settings to help customize your webpage:

Parent Webpage

The parent webpage is used primarily for the sitecrumb tracking. By setting a parent page you are telling the system (and the visitors to your website) that this page is a sub-page of the parent page. This is good in primarily for if your website template uses an in-depth role of webpages and to give your visitors the accurate use of the sitecrumbs.

Custom Website Template

On each webpage you can specify that particular webpage to use a different themed template other than the set website default. Also, if you select a different template, when a visitor goes to that webpage then they will see that selected templates default set menu's and side modules, unless if you have specified a custom menu and side modules (See Customized Menu's & Side Modules for a Webpage)

Last Updated Template

You have the option of turning the display of the "Last Updated On" text on or off for that webpage. Note that if you do turn it off, but you have the site setting 'Make the "Last Updated On" link back to the control panel' on, that link will not be available on that webpage.

Webpage Viewable on the Website

You have the option of being able to publish the webpage to the website, but turning it "off" from view.

Make this Webpage the Homepage

By checking this you will make the webpage the default page whenever someone access' your website.

Access Permissions

You are able to set the access rights permissions of which administrative groups will have access to the webpage. If you have the administrative privileges to assign to privileges you will see multiple checkboxes of all the administrative groups. If you do not have permission, you will see a dropdown with the option to select only your administrative group or allow all access.

If you are updating a webpage that is assigned to multiple administrative groups, but you do not have permission to assign permissions, then this section will be omitted from the administrator's view, but all of the privileges once the webpage update is submitted will stay in tact.

If there are no administrative groups within your website, then the system will automatically set the webpage to "Everyone" all access.

Customized Menu's & Side Modules for a Webpage

With each webpage, not only can you define a custom template, you can also specify the custom area's of the selected template for that webpage. This way, that webpage can have use a different menu, or display different side modules that are different from the default of the selected template.

Each template have what are called "Custom Area's". Within each area is where you specify what menu and / or side module will be. Templates can also have as many or as few of these custom area's, depending upon how the template was created.

When modifying the custom area for a webpage, the system will give you the number of area's depending on what template the webpage is using. You then select an area # from the dropdown, then select a menu group (A menu group is a group of specified menu links. See Menu Manager) or a side module and then press the "Add to Area" button to add your selection to the selected area.

Once you have all of the menu's and side modules in the area's that you want, you can re-arrange their order in their respective area's by simply clicking and dragging on their names up or down.

If you have difficulty knowing what area's are what on your template, simply click the link "Click here to view what area's are where on this template" and a popup with a screenshot of the different area's will appear. (Note: If the template creator did not include a screenshot within their template package you will not see the screenshot.)

Uploading Files

Uploading files are relatively easy to do. First navigate to the directory you want to upload the file to, and then click the "Upload a File" button. You will be able to upload up to 5 files at a time. The system is set for a maximum upload of 100MB, but depending on your server that amount maybe smaller. The system will be able to detect the server's set maximum filesize have it displayed above the upload fields. This means that if you are uploading a total of 5 files, the total size of all 5 files cannot exceed that maximum filesize.

Once you have selected your files that you want to upload, set the access permissions for those files. You are able to set the access rights permissions of which administrative groups will have access to the files. If you have the administrative privileges to assign to privileges you will see multiple checkboxes of all the administrative groups. If you do not have permission, you will see a dropdown with the option to select only your administrative group or allow all access. If there are no administrative groups within your website, then the system will automatically set the files to "Everyone" all access.

Once you click the "Upload" button, the system will upload the files to your server. If the Splash Frog system setting "Save History Uploads" is active, then a copy of that file will be saved as well in the file's history.

Note: If you are uploading a file that has the exact same name as an existing file on the server, the system will overwrite the existing file with the new one.

Creating Folders

Folder creation is a simple process. First navigate the File Manager using the folder tree to the folder where you want to create the new folder. Click on the "Add a Folder" button. Input in the name of the folder (you must use alpha-numeric characters only. Any spaces will be replaced with a '_'). Once you enter in the name, the system will automatically check and see if there is an already existing folder with the same name in the same area of your website. If there is one the system will give you a simple message and you must change the name before being able to submit the creation form.

Next set the access permissions for the folder. You are able to set the access rights permissions of which administrative groups will have access to the folder. If you have the administrative privileges to assign to privileges you will see multiple checkboxes of all the administrative groups. If you do not have permission, you will see a dropdown with the option to select only your administrative group or allow all access. If there are no administrative groups within your website, then the system will automatically set the folder to "Everyone" all access.

Click the "Create" button and then your new folder will be created.

Moving a File, Folder, or Webpage

Moving a file, folder, or a webpage is a simple process of dragging the item you want to move into the folder you want it to go to. Start by navigating to the folder that contains the item you wish to move. Then, click and drag the item (by clicking and dragging on the name or the icon of the item) to the desired folder in the left folder tree. If need be, expand the folder tree folder's by clicking the + symbol to the left of the name of the folder to expand and show its sub-folders.

Once you have the item hovering over the name of the folder you wish to move it in to, release the mouse and a confirmation box will appear. Click the "Move" button and the item will be moved into that folder. If you are moving a folder, all the contents of that folder (webpages, files, and sub-folders) will be moved along with it.

Note: If you do move an item, you will need to update any links within your webpages or any menu links that point to that item.

Rolling back a File or Webpage

Rolling back either a webpage or a file means that you are reverting that webpage or file to a previous version. To roll back hover over the menu icon of the item you want, and select "Rollback the Webpage" (or File). You will then see a list of available previous versions that you can roll the item back to. To view what that version is, click on the name of it. To select it, click on the radio button next to the one you want. Then click the "Update" button. Once completed, that webpage or file will be that previous version. For webpages, you can also have the rollback be published upon completion, schedule the rollback to complete at a future date, or send the rollback request to your approving administrative group.

When you do rollback a webpage or a file, only the content of the webpage and file will be rolled back. The name of the webpage or file, and its location will still remain the same.

Deleting a File, Folder, or Webpage

Note: You will have to have administrative group privilages, or be a Level 1 or Level 2 System Administrator to delete a file, folder, or a webpage.

Deletion of a file, folder, or a webpage is simple procedure for all three. First, navigate the left folder tree to find the item you want to delete. Hover over the menu icon next to the item and select the "Delete" option. You will then be prompted to verify you do want to delete the item. Click the "Delete" button and the item will be deleted. Depending on what you are deleting, the deletion process will differ between a file, folder, or a webpage as follows:

Webpage

When you go to delete a webpage, the webpage is not permanently deleted, but sent to to the trash bin, where once in there it can be recovered. (See Working with the Trash Bin) Also, when you delete a webpage, depending upon your administrative level you will be given the option of deleting the webpage now, schedule the deletion for a later date, or send the deletion request to your approving administrative group.

Uploaded Files

When you go to delete an uploaded file, the deletion will happen one of two ways:

1. If you have Splash Frog setup to save the history of uploaded files, then the file will be sent to the trash bin, where once in there it can be recovered. (See Working with the Trash Bin).
2. If you do not have Splash Frog setup to save the history of uploaded files, or the system cannot find the latest version within the file history, you will be asked to confirm to permanently delete the file. If you confirm, then the file is removed from the system permanently, and you will have to re-upload it to have it back.

Folders

When you go to delete a folder, the system will check to see if there are any existing files, folders, or webpages within it. If there are, you will have to delete all of those first before you can delete that folder. This is to help prevent an accidental deletion of a folder and all of its contents.

Working with the Trash Bin

Note: You will have to have administrative group privilages, or be a Level 1 or Level 2 System Administrator to delete a file, folder, or a webpage to view the Trash Bin.

The File Manager uses a trash bin system to help the accidental deletion of webpages, so that way those webpages can be recovered easily. If you have Splash Frog setup to save the history of uploaded files, then the deleted files will also be sent to the trash bin as well. In order to view the trash bin, you will need to be within an administrative group that has the ability to delete files, folders, and webpages, or you will have to be a Level 1 or Level 2 System Administrator.

When you go to view the trash bin, you will see a list of all the items that have been deleted, sorted by their name, and you will also see when it was deleted on. To restore a file, hover over the menu icon next to the item you want to restore, and click the "Restore" button. You will be given a confirmation that you do want to restore your selected item. Click on the "Restore" button, and the item will be restored to its original place within the website.

If you have since the deletion of the item added a new one with the exact same name, the system will append a number to the end of the restoring item's name, avoiding any over-writing of files.

If you have since the deletion of the item removed the folder of where it had used to belong to, the system will restore the item to the root (base) directory of the website.

Scheduled Webpages

Note: You will have to have administrative group privilages, or be a Level 1 or Level 2 System Administrator to publish a webpage to setup the schedule of a webpage.

Within the File Manager of Splash Frog you are able to schedule your webpages to perform certain actions at a given date. Those actions can be creating, updating, deleting, or rolling back a webpage. You must have administrative group privilages to at least publish your own content to be able to schedule a webpage, or you must be a Level 1 or 2 System Administrator.

From within the File Manager, you can review all of the currently scheduled webpages by clicking on the "View Scheduled Webpages" on the far left menu. You will see a complete list of all the webpages waiting to be published, being listed by their name and their scheduled date and time. You will also be able to see who setup the schedule and what the reason for the scheduling is (Create, Update, Delete, or Rollback). From here, you can do one of three things:

1. Update a Scheduled Time - You can effectively modify the time the webpage is suppose to be published.
2. Perform the Action Now - You bypass the scheduled time and force the reason for the webpage change to happen now.
3. Cancel the Scheduled Time - You can cancel the scheduled webpage change, making the changes not happen at the set time. If you do this, the reason and record of the webpage change still exists, as the system will move the scheduled changes into the approval system, where from there you can completely cancel the entire request all-together.

Webpage Approvals

Note: You will have to have administrative group privilages, or be a Level 1 or Level 2 System Administrator to approve the creation or changes to a webpage to view the Approve Webpage.

The Splash Frog File Manager system allows for you to have administrators the ability to make changes to your webpages, but not publish them without first being approved. This is good for if you are needing to have administrators be able to make changes, but not the full permission to publish whatever they want. You are able to send for approval a Creation, Update, Delete, Rename, or a Rollback of a webpage.

Updating a Pending Approval

You as an approving administrator, you have the ability to modify the submitted content when the approval submitted is for either a creation or an update of a webpage. Modifying the content is the same as maintaining it, except that when you're ready to save it, you can either go ahead and publish the content, schedule it for later, or save the changes for approving later.

Approving or Canceling an Approval

You as an approving administrator have the ability to quickly approve or cancel a submitted approval. Hover over the menu icon you wish to approve or cancel, and select the appropriate option.

Send it Back to the Submittor

One of the other features of the approval system is that you can send the submitted approval back to the submittor for revision (for creation or updating only). When you send the pending changes back, you can also send to the submittor your reason for sending it back, or any other instructions you want to give them.