There may be times when you want to copy one of your forms to another domain. Perhaps you created it on a test site and now need to install the final version on your client's server, or maybe you've created a custom form for use on all of your client sites.
Using BreezingForm's 'Package' option in the BreezingForms configuration screen, copying forms from one domain to another is a BREEZE, as long as the other domain is running Joomla! with the SAME OR A NEWER VERSION of the BreezingForms extension. (There may be some instances where it could be backwards-compatible and work on a site running an earlier version, but this cannot be guaranteed, though in most cases it should work with a form created using Classic Mode.)
When you create a package, you are actually creating an XML file which can then be shared with others. To send it via Email though, you might have to zip the file first, as not all Email applications/webhosts will accept XML files.
How do I create a package?
To create a package for installation on another domain, here's what you'll need to do. Go to Components > BreezingForms > Configuration. In the BreezingForms configuration screen, you'll see this:
- Click on 'Create Package' at the bottom of the Configuration screen.
Leave the ID section blank.
- Package Name
Give your package a name file name (no spaces).
Assign a version number to your form.
- Package Title
Enter the title of your package (spaces are allowed).
- Author Name
Enter your name.
- Author Email
Enter your Email address.
- Author URL
Enter your website URL, if applicable.
Enter a brief description of your package and/or form.
If there are copyright restrictions on your package or form, enter the terms here.
- Form Selection
Select the form that you wish to include in the package.
- Backend Menuitem Selection
Choose the Backend Menuitem that you wish to include in the package, if applicable.
- Script Selection
If you have created any custom scripts that should be exported with your form, select them here.
- Piece Selection
If you have created any custom pieces that should be exported with your form, select them here.
Then click on the Continue button. You will be prompted to save an XML file. (Be aware that your browser might block, or attempt to block it. Check for any warnings in that regard.)
∗ Note: If you create a package you do not need to choose all existing scripts and pieces. Please only choose your custom made scripts and pieces. The standard ones do already exist and do not need to be exported. If all of them are selected and if you export/import a form multiple times it could lead to hundreds of copies in your backend!
How do I install a package?
To install a package, here's what you'll need to do. Go to Components > BreezingForms > Configuration. In the BreezingForms configuration screen, you'll see this:
- Click on 'Package Installer' at the bottom of the Configuration screen.
- Upload File
Choose whether to upload the file from your hard drive ('from client') or from a file on your server. If you are uploading a file from your hard drive, you will see a 'Browse' button. Click on it to locate the package you wish to upload. If you are installing a package from a file on a server, select that radio button. In the field below, enter the path or URL to the file you are uploading. Then click on the "Install Package" icon locate at the top of the right-hand side of the page.
- Package Installation Report
Once installed, you will be directed to a Package Installation Report which contains a summary of the information provided by the package creator.
- Complete Installation
Click on "Continue" to complete the installation. Your form should now be accessible through the 'Manage Forms' link.