Skip to content

BC Import CSV simple example solution based on default eZ Publish PHP Cli Scripts to convert variable html into 100% valid ezxml into ezxmltext content object attribute by uploading img and a tags into ez images and urls replacing the html tags with content object embed tags. Tested to accurately import over a million content objects!

License

brookinsconsulting/bcimportcsv

Repository files navigation

BC Import CSV

This extension which provides a flexible solution providing a quick and simple import of content tree content objects content in csv format.

Version

  • The current version of BC Import CSV is 0.1.1

  • Last Major update: June 02, 2015

Copyright

  • BC Import CSV is copyright 1999 - 2016 Brookins Consulting and 2013 - 2016 Think Creative

  • See: COPYRIGHT.md for more information on the terms of the copyright and license

License

BC Import CSV is licensed under the GNU General Public License.

The complete license agreement is included in the LICENSE file.

BC Import CSV is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License or at your option a later version.

BC Import CSV is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The GNU GPL gives you the right to use, modify and redistribute BC Import CSV under certain conditions. The GNU GPL license is distributed with the software, see the file doc/LICENSE.

It is also available at http://www.gnu.org/licenses/gpl.txt

You should have received a copy of the GNU General Public License along with BC Import CSV in doc/LICENSE. If not, see http://www.gnu.org/licenses/.

Using BC Import CSV under the terms of the GNU GPL is free (as in freedom).

For more information or questions please contact: license@brookinsconsulting.com

Requirements

The following requirements exists for using BC Import CSV extension:

eZ Publish version

  • Make sure you use eZ Publish version 5.x (required) or higher.

  • Designed and tested with eZ Publish Platform 5.1

PHP version

  • Make sure you have PHP 5.x or higher.

Features

This solution provides the following features:

  • Command line script

  • Module view

Dependencies

This solution depends on eZ Publish Legacy only

Installation

Bundle Installation via Composer

Run the following command from your project root to install the bundle:

bash$ composer require brookinsconsulting/bcimportcsv dev-master;

Extension Activation

Activate this extension by adding the following to your settings/override/site.ini.append.php:

[ExtensionSettings]
# <snip existing active extensions list />
ActiveExtensions[]=bcimportcsv

Clear the caches

Clear eZ Publish Platform / eZ Publish Legacy caches (Required).

php ./bin/php/ezcache.php --clear-all;

Settings Customization

This extension provides a number of settings which affect the report generation process.

First create a settings override (global, siteaccess or extension) of file bcimportcsv.ini.append.php.

Then customize the settings as required.

Required settings

This solution only requires one setting be customized, AdminUserSiteAccessName.

You are required to set your admin siteaccess name within the AdminUserSiteAccessName setting variable.

This is required because the solution uses this content to run the report generation using the admin siteaccess scope which again is required for the entire solution to work correctly.

Usage

The solution is configured to work virtually by default once properly installed.

Usage - Command line script

Change directory into eZ Publish website document root:

cd path/to/ezpublish/ezpublish_legacy/;

Run the script to generate the report

php extension/bcimportcsv/bin/php/bcimportcsvcontentobjectimport.php --class-identifier=blog_post --creator=14 42742 ./var/bcimportcsv/67_0001.csv --script-verbose --script-verbose-level=2;

Usage - Module

The module view is optional but often the default way content editor admins use this solution

The module view can be used for simple regeneration of report and downloading of report

Access the module view using the following uri

http://admin.example.com/bcimportcsv/upload

Troubleshooting

Read the FAQ

Some problems are more common than others. The most common ones are listed in the the doc/FAQ.md

Support

If you have find any problems not handled by this document or the FAQ you can contact Brookins Consulting through the support system: http://brookinsconsulting.com/contact

About

BC Import CSV simple example solution based on default eZ Publish PHP Cli Scripts to convert variable html into 100% valid ezxml into ezxmltext content object attribute by uploading img and a tags into ez images and urls replacing the html tags with content object embed tags. Tested to accurately import over a million content objects!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published