Download the PHP package silverstripe/sitetreeimporter without Composer
On this page you can find all versions of the php package silverstripe/sitetreeimporter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download silverstripe/sitetreeimporter
More information about silverstripe/sitetreeimporter
Files in silverstripe/sitetreeimporter
Package sitetreeimporter
Short Description Imports indented plaintext files into a SilverStripe sitetree
License
Informations about the package sitetreeimporter
Site Tree Importer Module
Requirements
- SilverStripe 4 or later
Installation
No installation required.
Usage
Make a tabbed-out file as directed in the form that appears below. Make sure that you use tabs, not spaces.
Visit http://localhost/your-site-name/SiteTreeImporter?flush=1
.
Select your tabbed-out file in the file field, and tick the option boxes as appropriate:
Clear out all existing content? - This will delete everything from your site before running the importer. Use with caution! If you don't tick this, then the pages will be added to the existing site.
Publish everything after the import? - This will publish each of the pages that the importer creates. If you don't tick this, then the pages will be left as draft-only.
Format
The site tree import module lets you take a tabbed out file of the following format, and load it into your CMS as a site tree.
You can optionally include JSON encoded metadata as the last part of a line,
which will automatically save to properties on the Page
object.
This can be useful to determine URL paths or set custom titles.
Howto
Redirect URLs
Often an existing tree will need to be imported with URLs which map to different URLs on the new site.
While you could assign those manually to a .htaccess
based redirect, we found it useful to
store the old URL straight in the Page
object, and use SilverStripe's routing to handle the redirect.
In this example, we'll use the "redirected urls" module,
which routes based on a new data type called RedirectedURL
. In order to create it,
we add a custom setter to the Page
class, which gets called automatically if
a key named LegacyURL
is found in the imported JSON data.
Now you can import a tree based on the following data:
Related
See the static site connector module for a more sophisticated importer based on crawling existing HTML pages, and extracting content via XPATH.