Introduction
============

This package shows you how to use collective.transmogrifier to import news items into Plone.

By default, it uses dummy values that are hard-coded in the product itself to create some News Items,
so you can see how to even use transmogrifier. 

The main idea is that you can use this product as a skeleton for migrating content from other systems to Plone,
since you only need to pass in correct data instead of hard-coded dummy values.

Examples of real-life parsing HTML to extract data you need can be found in /branches folder of the product's repository at http://svn.plone.org/svn/collective/niteoweb.transmogrifier.simpleusage/branches/.

The product sets the following fields on newly created News Items:

    - title
    - text
    - date
    - category
    - author


Demo
====

Run the following set of commands::

    $ cd <workspace>
    $ virtualenv -p python2.4 --no-site-packages simpleusage
    $ cd simpleusage
    $ svn co https://svn.plone.org/svn/collective/niteoweb.transmogrifier.simpleusage/trunk ./
    $ bin/python bootstrap.py
    $ bin/buildout
    $ bin/instance fg
    
Then start your favorite browser and point it to http://localhost:8080/manage to add a new Plone site.
You can now use the following URL to start importing News Items: http://localhost:8080/<your_site_id>/@@import


Customizing
===========

First, create a branch for you to work on::

    $ cd <workspace>
    $ virtualenv -p python2.4 --no-site-packages johns_migration
    $ cd johns_migration
    $ svn copy https://svn.plone.org/svn/collective/niteoweb.transmogrifier.simpleusage/trunk https://svn.plone.org/svn/collective/niteoweb.transmogrifier.simpleusage/branches/johns_migration

    
Then, checkout your branch and build a development environment::

    $ svn co https://svn.plone.org/svn/collective/niteoweb.transmogrifier.simpleusage/branches/johns_migration ./
    $ bin/python bootstrap.py
    $ bin/buildout

Now you have everything you need to start your own migration. Open <workspace>/johns_migration/src/niteoweb.transmogrifier.simpleusage/transmogrifier.py in your favorite text editor.
Scroll all the way to the bottom to find a method 'source' and modify it so that it parses data from your source and returns it as a list of dicts. 

Once you're done, start Zope and point your browser to http://localhost:8080/<your_site_id>/@@import to start importing!