|
 |
Gigya's Developer Documentation > Wildfire Sharing Tool > Developer's Guide > UI Customization > Destination Sites Configuration
Destination Sites ConfigurationFrom $1IntroductionBy default, Wildfire displays all the available destination sites offered by Gigya, thus allowing your content to be distributed to numerous destinations. However, you may encounter the need to limit the destinations of your widget. This section discusses how to control the destination sites available on Wildfire, determine their order and their arrangement. By default, Wildfire displays all the available destination sites in a predefined arrangement, as follows: Three tabs are presented to the user - "Post", "Bookmark" and "Email". In addition, there is also a "Desktop" tab which is hidden by default. In each tab the most “popular” sites are displayed, in a predefined order of popularity. The list ends with a button labeled "More", which takes one to the next list of available destination sites.
There are several possibilities for modifying the default layout:
The following sections describe how to implement these possibilities.
Showing and Hiding TabsYou may control which services will be available for your site users by showing or hiding the relevant tabs. You may control which tabs are shown by one of two options:
As a result, the corresponding tabs appear \disappear, as the screen shot above demonstrates.
<config><display showBookmark="true" showEmail="false" showDesktop="true" ... ></display></config>
Mixed Single TabWildfire may be configured to combine all the destination sites of the different services ("Post" , "Bookmark", "Email" and "Desktop") in a single frame with a "Quick post" title, as the following screenshot demonstrates :
This change may only be performed manually in the code, according to the following instructions: Search for the initialization of the UIConfig parameter; paste the mixNetworks="true" attribute inside the "display" element. <config><display mixNetworks="true" ... ></display></config>
Notes:
Controlling the List of DestinationsYou may control the list of destination sites for each service tab individually, by using a set of specific parameters. Note - If the current user has either posted to a certain destination site or bookmarked it, this last destination will be displayed first in the relevant tab (the position of this destination site will precede the list, which is predefined), so as to provide an improved user experience.
Controlling the List of Post Destinations:You may define the destination sites which are displayed in the "Post" tab by either:
For example, you may wish to display the possibility of posting only to MySpace, Facebook, Orkut and Bebo sites, and to determine that the order should be: MySpace, Bebo, Facebook and Orkut. The following screenshot demonstrates this choice:
Instructions: (1) Choose the "Display" element in the tree. (2) Check \uncheck the checkboxes of the sites you wish to show \hide. Then move them "Up" and "Down" to arrange them according to your needs. (3) You will be able to see the outcome immediately in the Wildfire view on the upper right-hand side of the Wizard. The list of destination sites and their order is updated on the fly.
Two parameters control the list of destination sites to be presented in the "Post" tab, defining which destinations will be included in the list and which will be excluded. The networksToShow parameter defines the destinations which are to be included in the list. It also defines the order in which the destinations will be displayed. For example, to arrive at the same list as in the example above (MySpace, Bebo, Facebook, Orkut), your networksToShow list should look like: conf['networksToShow'] = "myspace,bebo,facebook,orkut"; The appearance of the Wildfire Post tab will conform to the way you defined. Additionally networksToShow can include an asterisk (*) to indicate any additional networks that are supported by Wildfire. Asterisks are useful for lists where you only wish to specify the order of certain destination sites. For example, if you wish to display Orkut first, Facebook second and then all the other supported sites, your networksToShow list should look like: conf['networksToShow'] = "orkut,facebook,*";
The networksToHide list allows you to define the destinations which you do not wish to display. This provides the ability to easily remove destinations without having to define all the destinations manually in the networksToShow list. For example, if you want to offer your users access to all destinations except Friendster, Bebo and Tagged, your networksToHide list should look like: conf['networksToHide'] = "friendster,bebo,tagged";
You may also combine the two parameters. For example, if you wish your list to begin with Myspace and Facebook, followed by all other supported sites with the exception of hi5 and vox, your networksToShow and networksToHide lists should look like: conf['networksToShow'] = "myspace,facebook,*"; conf['networksToHide'] = "hi5,vox";
Controlling the List of Bookmark Destinations:You may define the destination sites that will be displayed in the "Bookmark" tab by manually implementing some changes in your code (the setup wizard currently does not support this option). Two parameters control the destination sites in the "Bookmark" tab, defining which destinations will be included in the list and which will be excluded. The parameters are: bookmarksToShow and bookmarksToHide. This pair of parameters follows a similar logic to that of networksToShow and networksToHide, the pair of parameters discussed in the "Controlling the List of Post Destinations" section above.
For example, if you wish to have Twitter and LinkedIn first, followed by all the other supported sites with the exception of Reddit, your bookmarksToShow and bookmarksToHide lists should look like: conf['bookmarksToShow'] = "twitter,linkedin,*"; conf['bookmarksToHide'] = "reddit";
Adding Custom DestinationsYou may add new custom destination site buttons to Wildfire. This is implemented by setting the customNetworks configuration parameter with a special XML string. The XML string defines the new buttons, using the following format: conf[customNetworks] =
"<nets>
<net id="customNet1" name="Network 1 Display Name" iconURL="http://www.quarktet.com/Icon-small.jpg" service="POST"/>
<net id="customNet2" name="Network 2 Display Name" iconURL="http://www.quarktet.com/Icon-small.jpg" service="BOOKMARK"/>
</nets>;
Where: <net /> defines a single network button. Each button is defined using the following properties:
In the above example, two new buttons will be added - one to the "Post" tab and the other to the "Bookmark" tab.
When pressed, your custom button will activate the regular NetworkButtonClicked Event. The next page in the Developer's Guide is the Wildfire Events page, which is a guide to handling Events generated by Wildfire.
Tags:
Files (0) |
||||
|
