PHPackages                             spress/spress-import - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF &amp; Document Generation](/categories/documents)
4. /
5. spress/spress-import

ActiveSpress-plugin[PDF &amp; Document Generation](/categories/documents)

spress/spress-import
====================

A plugin for importing from various blog platform to Spress

v1.0.0(9y ago)264MITPHPPHP &gt;=5.5

Since Aug 4Pushed 9y ago2 watchersCompare

[ Source](https://github.com/spress/Spress-import)[ Packagist](https://packagist.org/packages/spress/spress-import)[ RSS](/packages/spress-spress-import/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

Import plugin for Spress
========================

[](#import-plugin-for-spress)

[![Build Status](https://camo.githubusercontent.com/3721cf1506c0c43ec1317078f6caa1b6c3035038f40c240a0414fcb0bd248ad7/68747470733a2f2f7472617669732d63692e6f72672f7370726573732f5370726573732d696d706f72742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/spress/Spress-import)

This plugin let you import posts and pages from others platforms to a Spress site.

Platforms supported
-------------------

[](#platforms-supported)

- [CSV files](#csv-files).
- [Wordpress WXR files](#wordpress-wxr-files).

Requirements
============

[](#requirements)

- php &gt;= 5.5.
- [Spress](http://spress.yosymfony.com) &gt;= 2.1.3.
- [Composer](https://getcomposer.org/).

How to install?
---------------

[](#how-to-install)

1. Go to `your-spress-site/` folder.
2. Run `composer require spress/spress-import`.
3. When you run `spress` command, import commands will be displayed under `import` namespace.

How to use?
-----------

[](#how-to-use)

See the concrete provider.

Source permalinks
-----------------

[](#source-permalinks)

Import plugin tries to preserve the source permalink of each item. To reach that goal, this plugin adds the attributes: `permalink` and `no_html_extension`.

e.g: for an item with the following permalink at source: `http://acme.com/what-is-new-this-time`the front matter block generated will be:

```
---
permalink: '/what-is-new-this-time'
no_html_extension: true
---
```

### CSV files

[](#csv-files)

This command imports posts from a CSV file.

The sign of `import:csv` command is the following:

```
import:csv [--dry-run] [--post-layout POST-LAYOUT] [--not-replace-urls]
[--not-header] [--delimiter-character DELIMITER-CHARACTER]
[--enclosure-character ENCLOSURE-CHARACTER]
[--terms_delimiter_character TERMS-DELIMITER-CHARACTER] [--]
```

Example of use:

```
$ spress import:csv /path-to/post.csv --post-layout=post
```

#### Options

[](#options)

- `--dry-run`: This option displays the items imported without actually modifying your site.
- `--post-layout`: Layout applied to posts. e.g: `--post-layout=post`.
- `--not-replace-urls`: Avoids to replace URLs in posts by local Spress URLs.
- `--not-header`: First row won't be treated as header.
- `--delimiter-character`: Sets the delimiter character. character `,` by default.
- `--enclosure-character`: Sets the enclousure character. character `"` by default.
- `--terms_delimiter_character`: Sets the delimiter character applied to terms in categories and tags columns.

#### CSV structure

[](#csv-structure)

Your CSV file will be read in with the following columns:

1. **title**
2. **permalink**
3. **content**
4. **published\_at**
5. **categories** (optional): a list of terms separated by semicolon. e.g: "news;events".
6. **tags** (optional): a list of terms separated by semicolon.
7. **markup** (optional) markup language used in content. e.g: "md", "html". "md" by default. This value will be used as filename's extension of the imported item.

#### Item attributes

[](#item-attributes)

List of attributes added by this provider to each item:

- `categories`: list of terms that represents the categories.
- `tags`: lists of terms that represents the tags.

### WXR files from Wordpress

[](#wxr-files-from-wordpress)

This command imports posts from a WXR file generated by Wordpress (community and dot com).

The sign of `import:wordpress` command is the following:

```
import:wordpress [--dry-run] [--post-layout POST-LAYOUT]
[--fetch-images] [--not-replace-urls] [--assets-dir ASSETS-DIR] [--]
```

Example of use:

```
$ spress import:wordpress /path-to/my-wxr-file.xml --post-layout=post
```

#### Options

[](#options-1)

- `--dry-run`: This option displays the items imported without actually modifying your site.
- `--post-layout`: Layout applied to posts. e.g: `--post-layout=post`.
- `--fetch-images`: Fetch images used in the Wordpress blog.
- `--not-replace-urls`: Avoids to replace Wordpress URLs in posts by local Spress URLs.
- `--assets-dir`: Relative folder to `src` directory. `content/assets` by default.

#### Item attributes

[](#item-attributes-1)

List of attributes added by this provider to each item:

- `author`: The author of the post.
- `excerpt`: The snippet of the post.
- `categories`: list of terms that represents the categories.
- `tags`: lists of terms that represents the tags.

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3616d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3321099?v=4)[Yo! Symfony](/maintainers/yosymfony)[@yosymfony](https://github.com/yosymfony)

---

Top Contributors

[![yosymfony](https://avatars.githubusercontent.com/u/3321099?v=4)](https://github.com/yosymfony "yosymfony (84 commits)")

---

Tags

phppluginspresspluginwordpresscsvspress

### Embed Badge

![Health badge](/badges/spress-spress-import/health.svg)

```
[![Health](https://phpackages.com/badges/spress-spress-import/health.svg)](https://phpackages.com/packages/spress-spress-import)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M2.9k](/packages/craftcms-cms)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M464](/packages/pimcore-pimcore)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

101466.4k45](/packages/friendsoftypo3-content-blocks)[silverstripe/framework

The SilverStripe framework

7223.7M2.7k](/packages/silverstripe-framework)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19664.8M1.6k](/packages/drupal-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
