Table of Contents
The absolute pre-requisite for using JoomlaPack Remote on your site is to have a fully functional installation of the JoomlaPack component. If you have not installed JoomlaPack yet, please visit our downloads page and download the version which is fit to your site. Make sure that JoomlaPack is able to take backups before proceeding with any preparation for use with JoomlaPack Remote!
Before using the desktop application it is absolutely necessary to install and setup JoomlaPack 2.0 (or later) component and the plg_jpremote plug-in on your site. This section only covers the installation and setup of the plug-in.
You can always get the latest version of the plug-in from our File Release System on JoomlaCode.org. Check the JoomlaPack Native Tools package releases. The plug-in is offered as an installable ZIP file.
![[Important]](/images/stories/docimport62/important.png) | Important |
|---|---|
Always use at least the version of the plug-in released with the version of JoomlaPack Remote you are using. Newer versions of the plug-in fix outstanding bugs and implement new features required by the desktop application. Using a newer version of the plug-in than that of the desktop application does no harm; the plug-in is designed to be backwards-compatible with the desktop application. |
![[Warning]](/images/stories/docimport62/warning.png) | Warning |
|---|---|
You are not supposed to extract the ZIP file you have downloaded! Joomla! will take care of that. |
In order to install it on your Joomla!™ site you have to follow the standard Joomla! extension installation procedure first. In short, you have to log in to the administrator back end and select the - menu item. In the Upload Package File area, please browse to the downloaded ZIP file and then click on the button.
The next step is to enable the web services on your site, if you
have not already done so. Select the -
menu item from the
Joomla! administrator back end menu. Click on the
System tab; on the upper-left box entitled
System Settings locate the Enable Web
Services options and set it to Yes. Then,
click on the button on the top tool
bar.
Finally, we need to enable the plug-in itself. In order to do
so, you have to select the -
menu item from the
administrator back end menu. To make life easier for you, select the
xmlrpc option from the Select
Type drop-down list on the top right corner of this page.
Locate the JoomlaPack Remoting XMLRPC services for
JoomlaPack 2.x item and make sure there is a green check
mark on the Enabled column. If it is a red circle
with a white X in it, just click on it and it will turn into a green
check mark. You are done!
| Warning |
|---|---|
Make sure that the JoomlaPack component is properly configured and able to take backups already. In any other case, attempting to use the plug-in may result in errors. For your convenience, please do not seek support regarding the plug-in if you are unable to perform backups from the component. You will only make it more difficult for us to identify the source of your problem, delaying finding the proper solution for it. |
Upgrading is by no means different than a normal installation. You have to follow the exact same procedure, but the last two steps are normally not necessary; the web services should be already enabled and the plug-in already published by default.
![[Tip]](/images/stories/docimport62/tip.png) | Tip |
|---|---|
You do not need to uninstall the old version when upgrading sites running on Joomla! 1.5.5 or later. The plug-in installation package utilizes the upgrade mode, introduced in Joomla! 1.5.5. |
The procedure for Joomla! 1.0.x site is much simpler. The first thing you need to do is to install the JoomlaPack component, version 1.2.3 or later. Then, go to JoomlaPack's Configuration page and enable the front-end backup feature. That's all there is to it. The XML-RPC services server is an integral part of the component and you just enabled it.
| Important |
|---|---|
Older versions of the component (i.e. 1.2.2 and earlier) can't work with JoomlaPack Remote, at all. |
The XML-RPC server URL for the two branches of the JoomlaPack component are:
JoomlaPack 1.2.x:
http://www.example.com/index.php?option=com_joomlapack&act=xmlrpc&no_html=1JoomlaPack 2.x:
http://www.example.com/xmlrpc/index.php
You must replace www.example.com with
the real URL of your site.
In the former case, the XML-RPC communications layer is provided by JoomlaPack, using a local copy of the XML-RPC library inside the component's directory. In the latter case, the XML-RPC communications layer is provided by Joomla! itself, using its own copy of the library. The plug-in acts as a bridge between the XML-RPC layer and JoomlaPack's backup core.
