https://github.com/piotr-cz/cockpit-import

Spreadsheet import module for Cockpit CMS
https://github.com/piotr-cz/cockpit-import

angularjs cockpit-cms csv import javascript php

Last synced: 11 days ago
JSON representation

Spreadsheet import module for Cockpit CMS

• Host: GitHub
• URL: https://github.com/piotr-cz/cockpit-import
• Owner: piotr-cz
• License: mit
• Created: 2015-11-05T22:43:38.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2020-09-04T22:50:25.000Z (about 4 years ago)
• Last Synced: 2024-10-12T23:55:07.316Z (26 days ago)
• Topics: angularjs, cockpit-cms, csv, import, javascript, php
• Language: JavaScript
• Size: 205 KB
• Stars: 23
• Watchers: 5
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Spreadsheet import module ![icon](./artwork/icon.png)

Module for importing spreadsheet as collection entries in [Cockpit CMS](http://getcockpit.com/)

## Features

- Import from CSV files or JSON files

  _(generated by Cockpit collection export functionality)_

- Localization

- Auto-assign fields based on header

  _(Column names must match collection field names)_

- Filters

  - Text

  - Select

  - Boolean

  - Lookup entry matching Name _(for field type `link-collection`, useful for setting up categories)_

    _For multiple collection links, use Vertical bar `|` as a separator._

    _Collection must have field named `name`_

  - Location

    _(Geolocate addresses)_

## Requirements

- Cockpit v0.13

- for CSV files IE10+/ Safari 6+ (see [Papaparse browser compatibility](http://papaparse.com/faq#browsers))

## Installation

### Manual

1. Download [latest release](https://github.com/piotr-cz/cockpit-import/releases/latest) and place in `[cockpit-path]/modules/addons/Import` or

   ```sh

   cd [cockpit-path]/modules/addons

   git clone https://github.com/piotr-cz/cockpit-import Import

   ```

2. Open cockpit backend.

3. In top-right corner you'll see _Import_ button.

### Using composer

1. In composer.json add path where cockpit modules are located:

   ```json

   "extra": {

       "installer-paths": {

           "cockpit/modules/addons/{$name}": ["type:cockpit-module"]

       }

   },

   ```

2. Install module using command

   ```sh

   composer require piotr-cz/cockpit-import

   ```

## Usage

1. Select collection and file

   ![Parsing](./artwork/screenshots/1-parsing.png)

2. Map collection fields to spreadsheet columns

   ![Data mapping](./artwork/screenshots/2-data-mapping.png)

3. Tune up processing options and click Import

   ![Processing](./artwork/screenshots/3-processing.png)

## Authors

* [piotr_cz](https://github.com/piotr-cz)

### 3p libraries

* [Papaparse](http://papaparse.com/) (MIT)

## Issues/ Feature requirements

Submit issue or feature requirement [here](https://github.com/piotr-cz/cockpit-import/issues)

[Latest](https://github.com/piotr-cz/import/archive/master.zip) development version

## Licensed under MIT License