From 90b0d11c5c2f2cde507bbfc204e49befdecf4540 Mon Sep 17 00:00:00 2001 From: Evgeny Fadeev Date: Fri, 17 Jun 2011 18:08:42 -0400 Subject: added documentation for zendesk import --- askbot/doc/source/import-data.rst | 32 ++++++++++++++++++++++++++------ askbot/doc/source/index.rst | 2 +- 2 files changed, 27 insertions(+), 7 deletions(-) diff --git a/askbot/doc/source/import-data.rst b/askbot/doc/source/import-data.rst index c2cfc1b3..e0158d81 100644 --- a/askbot/doc/source/import-data.rst +++ b/askbot/doc/source/import-data.rst @@ -4,17 +4,37 @@ Import other forums into Askbot =============================== -At this time only StackExchange import is supported. +Askbot supports importing of data from StackExchange and Zendesk. -There are two ways to import your StackExchange dump into Askbot: +.. warning:: + If your database contains any data prior to importing, please back it up before proceeding. + +StackExchange +============= + +Add `askbot.importers.stackexchange` to the list of `INSTALLED_APPS` list in your `settings.py`, then run:: + python manage.py syncdb + +Then there will be two ways to import your StackExchange dump: * via the web at url `/import-data/`, relative to your forum installation * using a management command:: python manage.py load_stackexchange /path/to/your-se-data.zip -Before importing the data, an entry `askbot.importers.stackexchange` must be added to -the `INSTALLED_APPS` list in your `settings.py` file and a command `python manage.py syncdb` run -to initialize the stackexchange tables. - In the case your database is not empty at the beginning of the process - **please do back it up**. + +Zendesk +======= +Add `askbot.importers.zendesk` to the list of `INSTALLED_APPS` in the `settings.py`, +run `python manage.py syncdb`. + +Prepare your zendesk files: put all your .xml files into one directory and tar-zip it:: + + mkdir somedir + mv *.xml somedir #select the zendesk xml files and move them to the directory + tar cvfz zendesk.tgz somedir #name of the tgz file is not important + +Then run the import script:: + + python manage.py import_zendesk zendesk.tgz #file name is the parameter diff --git a/askbot/doc/source/index.rst b/askbot/doc/source/index.rst index c8580a46..2653b2df 100644 --- a/askbot/doc/source/index.rst +++ b/askbot/doc/source/index.rst @@ -19,7 +19,7 @@ at the forum_ or by email at admin@askbot.org Create and configure the site files Initialize the database tables Deploy on a webserver - Import data (StackExchange) + Import data (StackExchange & ZenDesk) Appendix A: Maintenance procedures Appendix B: Sending email to askbot Appendix C: Optional modules -- cgit v1.2.3-1-g7c22