https://github.com/mlocati/pixel2to9

An online tool that lets you convert Concrete CIF data from Pixel 2 to Pixel 9
https://github.com/mlocati/pixel2to9

Last synced: 4 days ago
JSON representation

An online tool that lets you convert Concrete CIF data from Pixel 2 to Pixel 9

• Host: GitHub
• URL: https://github.com/mlocati/pixel2to9
• Owner: mlocati
• License: mit
• Created: 2024-10-29T17:49:54.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-02-03T10:27:39.000Z (3 months ago)
• Last Synced: 2025-04-30T07:19:04.644Z (11 days ago)
• Language: TypeScript
• Homepage: https://mlocati.github.io/pixel2to9/
• Size: 885 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build](https://github.com/mlocati/pixel2to9/actions/workflows/build.yml/badge.svg)](https://github.com/mlocati/pixel2to9/actions/workflows/build.yml)

## Convert Pixel2 to Pixel9 Concrete CMS CIF Files

Do you have a website with concrete5 v8 that uses the old Pixel 2 theme and you want to switch to Concrete CMS v9+ with a new [Pixel 9](https://market.concretecms.com/products/2140e37d-cf89-11ee-b9df-0a97d4ce16b9) theme?

You can do the following:

1. In your old concrete5 v8 website install the [Migration Tool package](https://github.com/concretecms/addon_migration_tool)

2. Export the website content to XML files (the so-called CIF Format)

3. Convert the XML files with [this tool](https://mlocati.github.io/pixel2to9/)

4. In your new ConcreteCMS v9+ website install the [Migration Tool package](https://github.com/concretecms/migration_tool)

5. Import the XML files

## Sample Conversion

This tool can convert, for example, this CIF fragment

```xml

  

    

      

        american-sign-language-interpreting

      

    

  

```

to

```xml

   

      <customClass>

         utl:text:align:end

      </customClass>

   

   

      

         

            fas fa-american-sign-language-interpreting

         

         

      

   

```

## Maintainer instructions

### Local test

In order to build and run this app locally:

1. Install [NodeJS](https://nodejs.org/) 22 LTS

2. Install the npm dependencies with `npm ci`

3. Run a local server with the app with `npm run dev`

### Data conversion

Data for the block types is converted by the converters in the `src/Conversion/Converter/Block directory`.

If you add a new block converter, please remember to add it to the `Converters` array defined in the `src/Conversion/Converter.ts` file.

### Updating the published app

The app is (re)created automatically everytime something is pushed to the repository: you only have to code, the dirty work will be done automatically :wink:.