---- dataentry integration ----
type                           : integration #do not change this line
supports-foxycart-version-from : 1.0 #Minimum required FoxyCart version for this to work
supports-foxycart-version-to   :  #Last FoxyCart version that supports this (leave empty if unknown)
systems                        : FoxyCart #the system(s) that the integration is for, separated with commas if more than one
name                           : Bulk Subscriptions Exporter #the name of the integration
description                    : Export your subscriptions in bulk as a single file
tags                           : subscriptions, reports, export #tags, separated by commas. don't include the "system" here.
date_dt                        : 2017-06-28 #the date in YYYY-MM-DD format
version                        : 1.0 #if you have a version for your code, enter it here
developer_url                  : http://www.foxycart.com #if you'd like a link back to your site, stick it here
----



====== Bulk Subscriptions Exporter ======


===== Description =====
{{ :integration:foxycart:bulktransactionsexport.jpg?nolink&300|}}At present, it's not possible to export subscription data from within the FoxyCart administration, just filter and alter them within the subscriptions section. It's possible to export transactions using the API, but not everyone is comfortable setting up a script to do that.

This script will allow you to export any number of subscriptions required, as a single file.

===== Installation =====

  - Download the .zip file below
  - Extract the contents, and edit settings.php
     - Add your stores API Key (as found in the advanced page of your stores FoxyCart Administration)
     - Set a custom passphrase
     - Set the folder that exports will be added to
  - Upload the extracted files and folders to your server, to a folder that is not linked to publicly, and create the export folder that you specified in settings.php inside that structure
  - Navigate to where you uploaded the files in a browser, and follow the prompts

===== Requirements =====
  * FoxyCart version 1.0+
  * PHP
  * Curl (PHP Library)

===== Notes =====

When you load up the tool, you'll see a form to specify your store domain, passphrase and the filters you'd like to apply to this export. After submitting the form, a dialog will appear which will give you an update of how the export is going, including a rough timeframe of how much longer the export will take. It should also error nicely and display any errors to you within that dialog.

Once the export is complete, a button will appear to download the file, once clicked and the download has completed, another button will appear to delete the existing file. This is a safety precaution to help prevent whole exports of customers data from sitting on your server where you may forget about it. Make sure you click that button to delete the file from your server once you've downloaded it.

<WRAP center round important 90%>
The security of this script and the exported customers data is up to you. Please note the risks involved with having full exports of customers data on your server and proceed accordingly.
</WRAP>


===== Code =====
  *  {{ :integration:foxycart:subscription_exporter_1.0.zip |Bulk Subscriptions Exporter, v1.0}}