Services
Tools & Resources
Community
Resource Resolution
The order in which specific types of behavior or views load, from 301 redirects to 404s.
When a request is served by WebEngine, it reads the url path and attempts to match the url path to a content item resources. URL are checked against resource in a specific order, and will resolve the resource first if a match is found. If two resources share a URL path, then the one that loads first will resolve and the other is ignored.
Resource load order:
- 1.Static files generated by Zesty.io: site.css and site.js
- 2.Instant JSON API e.g. /-/instant/7-zyx-zyxzyc.json
- 3.GQL API e.g. /-/gql/*
- 4.Static files generated by Zesty.io: sitemap.xml, feed.xml, robots.txt
- 5.Legacy JSON endpoints e.g. /-/custom/
- 6.Well Known Files e.g. /.well-known/*
- 7.Custom endpoints e.g. /custom/endpoints.json
- 8.Legacy HTML endpoints e.g. /ajax/
- 9.Content Models Views if a content item's meta path matches the request page e.g. /about/team/
- 10.Wild Card Views e.g. /store/*/cool-shirt/
- 11.301 redirects
- 12.404 Pages e.g. when no resources match the url pattern
Base Directory Setting
Overview
Zesty.io will default all automated assets files to the root
/ directory unless the base directory setting has been added and set.
there is a setting on the instance with category:general key:base_directory with a directory set as its value e.g. /blog/Base Directory and Zesty.io Auto-created Files
Once the Base Directory settings has a value the Zesty.io auto-created files listed below will be immediately affected.
- site.js
- site.css
- sitemap.xml
- robots.txt
- feed.xml
Using the Base Directory setting with non-automated files
Other files created in the code editor such as custom endpoints must be manually named to follow the path of your choice. If you want content items to follow the same path as the Base Directory setting value, then a content model must exist with that path. For example, if you're using Zesty.io WebEngine only for your website's
/blog/ subdirectory then you need to setup a content item as a placeholder with /blog/ as its URL and create the Base Directory setting (as shown below) with the value /blog/. Adding the Base Directory Setting
1
{
2
"category": "general",
3
"keyFriendly": "Base Directory",
4
"key": "base_directory",
5
"value": "",
6
"admin": false,
7
"parselyAccess": false,
8
"dataType": "text",
9
"options": "",
10
"tips": ""
11
}
Copied!
If you know what value you want the base directory set to go ahead and add it to the JSON body under
value.Last modified 9mo ago
Export as PDF
Copy link
Contents
Base Directory Setting