The part which starts with a Left Bracket ( { ) and ends with a Right Bracket ( } ) is the extension ID. (Including the brackets themselves).
Place the unpacked files in a folder named after the extension ID you've just located, and package this folder into your installer.
In your application package:
1.
2. Once the profile we wish to install onto has been found, just copy the extension
ID folder from within your packaged application into the following folder:
%APPDATA%\Mozilla\Firefox\Profiles\<profileName>\extensions\
3. To control certain client-side behaviors (similar to using parameters for the IE installation), place a file called setup.ini within the extension ID folder you've just unpacked onto the user's computer.
You can fill this setup.ini file with one or more of the following parameters:
_START_PAGE_=TRUE/FALSE
_SET_DEFAULT_SEARCH_=TRUE/FALSE
_OPEN_UNINSTALL_PAGE_=TRUE/FALSE
_OPEN_WELCOME_DIALOG_=TRUE/FALSE
_OPEN_THANKYOU_PAGE_=TRUE/FALSE
Example of such a setup.ini file is given below:
Flow 2 – if <em:type NC:parseType="Integer">32</em:type> exists in install.rdf, then this is a Dual XPI extension.
This means there are two XPI's contained within the XPI we've just unpacked, which are the actual extensions we wish to install to the user's computer.
Unpack the two XPI's found within the XPI we've just unpacked.
Go into each of the two folders and note the following:
We have to identify the toolbar's Extension ID.
To do so, you can look through install.rdf for a line
starting with <em:id>
The part which starts with a Left Bracket ( { ) and ends with a Right Bracket ( } ) is the extension ID. (Including the brackets themselves).
Place the unpacked files in a folder named after the extension ID you've just located, and package this folder into your installer.
This is to be done for each of the two internal XPIs as described above.
In your application package:
1. We would like to install the extension into the user's active Firefox profile, but you can choose whichever profile you'd like.
To find the list of all profiles the current user has read the contents of the following file:
%APPDATA%\Mozilla\Firefox\profiles.ini
2. Once the profile we wish to install onto has been found, just copy the extension ID folder from within your packaged application into the following folder:
%APPDATA%\Mozilla\Firefox\Profiles\<profileName>\extensions\
3. THE FOLLOWING SHOULD NOT BE DONE FOR THE EXTENSION WITH ID " engine@conduit.com"
To control certain client-side behaviors (similar to using parameters for the IE installation), place a file called setup.ini within the extension ID folder you've just unpacked onto the user's computer.
You can fill this setup.ini file with one or more of the following parameters:
_START_PAGE_=TRUE/FALSE
_SET_DEFAULT_SEARCH_=TRUE/FALSE
_OPEN_UNINSTALL_PAGE_=TRUE/FALSE
_OPEN_WELCOME_DIALOG_=TRUE/FALSE
_OPEN_THANKYOU_PAGE_=TRUE/FALSE
Example of such a setup.ini file is given below:
UI references
The following functionality and disclaimers must be part of the integration dialog screen:
- Checkboxes:
- Checkbox for approving the toolbar installation
- Checkbox for changing homepage settings
- Checking for changing the search default settings.
·The publisher may choose weather as a default the checkboxes will be checked or not unless specified otherwise in the Publisher Agreement.
- The user must agree to the EULA and Privacy Policy in order to complete the installation.
- Updated Toolbar image must be presented.
- The toolbar image shall not include any reference to the search engine which is provided with the toolbar.
- The name + the logo of the toolbar.
Enabling the Toolbar to Execute the Application
To enable the Conduit toolbar to execute your application:
1. Add to the registry a key with your application alias, for example myApp.exe.
Add the following key to the registry, to add an application alias for a specific user: HKEY_CURRENT_USER\Software\Conduit\AppPaths\
myApp.exe
Add the following key in the Registry Editor, to add an application alias for all users: HKEY_LOCAL_MACHINE\Software\Conduit\AppPaths\
myApp.exe
On Windows Vista it is strongly recommended that you add the
key to HKEY_LOCAL_MACHINE
2. Add a string value to the new key as follows:
Name = AppPath.
Value = The full path to your application on the end users machine.
For example, C:\Program Files\myApp\myApp.exe
Figure 3 Registry Editor Displaying the Application Path Key
Launching Your Application from the Toolbar
To add an application button or menu application item to your Conduit toolbar:
1. Navigate to your Conduit account by entering the following URL in your browser: http://accounts.conduit.com/Login/.
2. In the Community Toolbar Name and Password fields enter your login information.
The Toolbar screen appears.
Figure 4 Adding Components to your Toolbar
3. For instructions on:
Adding an application button to your toolbar, see Adding an Application Button on page 10.
Adding a menu application item, see Adding a Menu Application Item on page 11.
Adding an Application Button
An application button enables you to launch your application from your toolbar.
To add an application button to your Conduit toolbar:
1. From the Toolbar screen, click Application Button or 
to add an application button to your toolbar.
The Add Application Button screen appears.
Figure 5 Add Application Button
2. Follow the screen's instructions for selecting an icon and a caption for the application button.
3. In the Registered Application Alias field, enter the name under which you have registered your application. This name should be the exact alias that your application setup writes to the registry.
4. You can optionally specify parameters to be passed from the toolbar when it is launched from the application, the URL from which your application can be downloaded, and the menu application item's tooltip text.
5. Click Save.
The application button is added to your toolbar.
Adding a Menu Application Item
You can add a menu to your toolbar containing an application button that enables you to launch your application from your toolbar.
To add a menu application item to your Conduit toolbar:
1. In the Adding Components to your Toolbar screen (see Figure 4), click Button with Menu or 
to add a drop down menu to your toolbar.
The Add Button with Menu screen appears.
Figure 6 Add Button with Menu
2. Follow the screen's instructions for selecting or uploading an icon for the application button.
3. Click 
to edit the drop down menu.
The Edit Menu Item dialog box appears.
Figure 7 Edit Menu Item Dialog Box
4. Enter the Edit Menu Item information as follows:
In the Caption field, enter the text that will appear on the menu application item.
In the Registered Name field, enter the name under which you have registered your application. This name should be the exact alias that your application setup writes to the registry.
You can optionally specify parameters to be passed from the toolbar when it is launched from the application, the URL from which your application can be downloaded, the menu application item's tooltip text, and the location of the icon that will appear on the menu application item.
5. Click Save in the Edit Menu Item dialog box.
6. Click Save in the Add Button with Menu screen (see Figure 6 ).The Menu Application Button is added to your toolbar.
[Last updated:March, 2011]