File Manager

Quick Start

File Naming Best Practises

When creating a page (or file) via FTP (or via the admin File Manager), please follow these best practises to avoid unpredictable result and/or errors:

4

Duplicate File Names

Do not create files with the same name but with different variations of the same file extension. Eg; myfile.html and myfile.htm

Doing so may result in inconsistent updating of file content when one or the other file is changed, along with other errors.

5

Empty File Names

Do not create files with an empty name (eg: .htm, .html).

The CMS logic of creating and changing the page via FTP, or via the admin File Manager, will ignore such files and will not result in the creation of a page.

6

Reserved URL Characters

Avoid using % and # characters in file names - particularly where these file names may be referenced in the URL (ie: as a link to a page or file). These characters are used in standard URL operations, therefore, including them in links/URLs can cause conflicts with existing URL constructs.

If these characters are to be used in your file naming, ensure any links/paths to such files are correctly URL encoded.

The URL encoding for these characters is listed below:

% –> %25
# –> %23

You can either manually encode these characters or make use of the Liquid filter url_encode.

Manual example:

// actual file name
<a href="/path/to/#my100%file.html">My Link</a>

// encoded file name
<a href="/path/to/%23my100%25file.html">My Link</a>

Liquid example:

{% assign fileSlug = "#my100%file.html" %}
<a href="/path/to/{{fileSlug | url_encode}}">My Link</a>

<a href="/path/to/%23my100%25file.html">My Link</a>

7

Folder and File Name Case Sensitivity

The Treepl CMS file system is case-sensitive and will resolve folders and files only from a matching-case request. Be sure to use matching letter case in your file paths and links.

For more information on system case sensitivity, see the File System article here.

Directory Structure

You have the freedom of creating your own folders and files within your sites directory structure. Keep in mind though, that Treepl CMS has certain directories/folders within a sites file structure which are utilised for system functionality (indicated below by the Treepl CMS icon ) and are either not accessible via the File Manager or should not be edited as they will be overriden with any version updates affecting those files.

The default system directory structure (and FTP access) is outlined below:

• ROOT
• cms-assets
  • css
    • event-calendar.min.css
    • jquery.fancybox.min.css
    • main.css
  • includes
    • event-calendar.inc
  • js
    • event-calendar.min.js
    • jquery.fancybox.min.js
    • payment.js
• Contact
  • ContentTemplates
    • Master.html
  • EmailTemplates
    • System Default.html
  • Forms
    • [your form name].html
  • MenuLayouts
    • [your_menu_alias]
      • Default
        • item.layout
        • menu.layout
        • sub_items.layout
  • ModuleLayouts
    • Custom
      • [YourCustomModule]
        • Detail_Detail.html
        • List.html
    • System
      • Banner
        • List.html
      • BannerGroup
        • List.html
      • Blog
        • Blog List Layout.html
        • General Blog Layout_Detail.html
      • BlogPost
        • List.html
        • Post Detail_Detail.html
      • Event
      • EventGroup
      • FAQGroup
        • List.html
      • FAQQuestion
        • List.html
      • GallerySlider
        • Detail_Detail.html
        • List.html
      • ItemAuthor
        • Detail_Detail.html
        • List.html
      • Page
        • Page Detail_Detail.html
        • Site Search List.html
      • PageFolder
        • Folder Detail_Detail.html
      • Slide
        • List.html
  • Pages
    • home.html
  • Snippets
  • SystemEmails
    • confirm-email-notification.html
    • invoice.html
    • password-retrieve-email.html
    • secure-zone-login-details.html
    • workflow-notification.html
  • SystemPages
    • 401.html
    • 403.html
    • 404.html
    • default-page.html
    • email-confirmation.html
    • error-page.html
    • form-submission-results.html
    • request-reset-password-result.html
    • request-reset-password.html
    • reset-password.html
  • WorkflowEmails
• _tmp

Related Articles

• Site Settings & Management
  Site Globals
  Site Globals, under ‘Settings’, is where you can set up customised data points for your...
• Extras
  Image Processor
  Treepl CMS utilises the ImageProcessingModule which allows you to perform image manipulations (such as resizing, cropping, quality/compression, filters, etc.) simply by adding URL query string parameters to your image source paths.
• Content Modules
  Pages
  Pages allow the creation and management of standard page content and folders. Pages can be arranged within folders, secured from unauthorised access, hidden from either site search or search engines, assigned to templates and given full SEO properties among various other settings.
• Liquid Components
  countries
  This component renders a form select element of all country names and country codes by default, and can also be used to output country codes/names to a Liquid collection.
• Content Editing
  Admin Editor (WYSIWYG/Code View)
  
• Website Templates
  *Bikes
  
• Website Templates
  *Clothing Store
  
• Website Templates
  Coffee
  
• Website Templates
  *Coworking
  
• Website Templates
  Digital Agency
  
• Website Templates
  Furniture
  
• Website Templates
  *Hair Salon
  
• Website Templates
  Max
  
• Content Editing
  On-Site Editor (OSE)
  The OSE is an in-context-editor that allows for quick and simple editing and styling of on-page text content directly within the context of the page (while viewing the live website).
• Content Editing
  On-Site Editor (OSE) PRO
  The On-Site Editor allows admin users to manage designated content from the front-end of the website in a more streamlined and intuitive manner.

External Resources

There are currently no external resources available.

Please let us know if you have any other contributions or know of any helpful resources you'd like to see added here.

Questions?

We are always happy to help with any questions you may have.
Visit the Treepl Forum for community support and to search previously asked questions or send us a message at support@treepl.co and we will consult you as soon as possible.