AppSuite:Upsell tools - Revision history

Khgras at 10:26, 12 July 2016

2016-07-12T10:26:48Z

@@ Line 3: / Line 3: @@
 <!-- !!! -->
-'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. Sine Upsell is usually very customer specific, we do only provide the framework.
+The content on this page has moved to https://documentation.open-xchange.com/latest/ui/features/upsell-tools.html.
-__TOC__
+Note: Open-Xchange is in the process of migrating all its technical documentation to a new and improved documentation system (documentation.open-xchange.com). Please note as the migration takes place more information will be available on the new system and less on this system. Thank you for your understanding during this period of transition.
 [[Category:AppSuite]]
 [[Category:Sales]]
 [[Category:Administrator]]

Frank.paczynski at 13:51, 10 February 2016

2016-02-10T13:51:27Z

← Older revision		Revision as of 13:51, 10 February 2016
Line 1:		Line 1:
			<!-- !!! -->
			<!-- PLEASE APPLY CHANGES ONLY TO THE NEW TECHNICAL DOCUMENTATION: wd/frontend/web/documentation -->
			<!-- !!! -->

	'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. Sine Upsell is usually very customer specific, we do only provide the framework.		'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. Sine Upsell is usually very customer specific, we do only provide the framework.

Tierlieb: /* The Upsell Wizard */

2013-12-17T15:43:59Z

The Upsell Wizard

@@ Line 69: / Line 69: @@
 == The Upsell Wizard ==
 The Upsell Wizard is a small shopping cart application that displays things that can be sold. They process is the usual three-step process of putting items in your cart, reviewing them and ordering them. Upon completion the Wizard calls an URL with the ordered items as well as the shoppers's ID and context number. It is left to the provider to implement some handler for that.
 == Making all of it work ==

Tierlieb: /* The Upsell Bubbles */

2013-12-17T15:36:41Z

The Upsell Bubbles

@@ Line 48: / Line 48: @@
 == The Upsell Bubbles ==
 Upsell bubbles are little popups based on hopscotch, similar to the [[AppSuite:Guided tours|guided tours]]. They show up after a given amount of time and point to a defined UI element to display some text. Clicking on them starts the Upsell Wizard (unless you click "cancel", of course).
 == The Upsell Wizard ==

Tierlieb: /* The Upsell Widget */

2013-12-17T15:31:09Z

The Upsell Widget

← Older revision		Revision as of 15:31, 17 December 2013
Line 34:		Line 34:
	text: 'More awesome stuff'		text: 'More awesome stuff'

	What you can see here is that an advertisement consists of several slides. Due to some peculiarities of the App Suite YAML parser, you have to name them "slide?" with a number. ~~They~~ will be sorted alphabetically, so if you plan to use more than 10 slides, remember to pad the number with enough zeros, the first slide being 00, the second being 01.		What you can see here is that an advertisement consists of several slides. Due to some peculiarities of the App Suite YAML parser, you have to name them "slide?" with a number and cannot use an array. The slides will be sorted alphabetically, so if you plan to use more than 10 slides, remember to pad the number with enough zeros, the first slide being 00, the second being 01.

	Slides can be provided in different languages. This example provides slides only for en_US. The slides need to match the user language exactly (sorry, no smart guessing so that British users with en_UK get the en_US version). The system defaults to en_US when no appropriate language can be found.		Slides can be provided in different languages. This example provides slides only for en_US. The slides need to match the user language exactly (sorry, no smart guessing so that British users with en_UK get the en_US version). The system defaults to en_US when no appropriate language can be found.

Tierlieb: /* The Upsell Widget */

2013-12-17T15:30:31Z

The Upsell Widget

← Older revision		Revision as of 15:30, 17 December 2013
Line 28:		Line 28:
	type: text-bottom		type: text-bottom
	image: 'https://image1'		image: 'https://image1'
	text: ~~<p>~~Awesome stuff~~</p>"~~		text: 'Awesome stuff'
	slide2:		slide2:
	type: text-top		type: text-top
	image: 'https:image2'		image: 'https:image2'
	text: ~~"<p>~~More awesome stuff~~</p>"~~		text: 'More awesome stuff'

	What you can see here is that an advertisement consists of several slides. Due to some peculiarities of the App Suite YAML parser, you have to name them "slide?" with a number. They will be sorted alphabetically, so if you plan to use more than 10 slides, remember to pad the number with enough zeros, the first slide being 00, the second being 01.		What you can see here is that an advertisement consists of several slides. Due to some peculiarities of the App Suite YAML parser, you have to name them "slide?" with a number. They will be sorted alphabetically, so if you plan to use more than 10 slides, remember to pad the number with enough zeros, the first slide being 00, the second being 01.
Line 39:		Line 39:

	The delayInMilliseconds represents the transition time from one slide to the next.		The delayInMilliseconds represents the transition time from one slide to the next.

			The text can contain HTML and is inserted via the innerHtml method of JQuery in case you feel the need for markup.

			The value of "image" is put into the src attribute of an <img/;gt; element, so you can use a local path as well as a URL.

			The type can be one of text-top, text-bottom, text-only and image-only. Text usually takes up a third of an ad that also contains an image. Text and image are cut off in case they exceed the space.

	== The Upsell Bubbles ==		== The Upsell Bubbles ==

Tierlieb at 15:27, 17 December 2013

2013-12-17T15:27:30Z

@@ Line 1: / Line 1: @@
-'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite.
+'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. Sine Upsell is usually very customer specific, we do only provide the framework.
 __TOC__
@@ Line 5: / Line 5: @@
 == The Upsell Widget ==
 The Upsell widget is a widget displayed on the portal. It can show images, text or combinations thereof. A widget can contain several "slides". A click on the widget starts the Upsell Wizard. There can be more than one Upsell Widget (just remember not to annoy your customer with too many!). Upsell widgets can be moved, but not removed from the portal.
 == The Upsell Bubbles ==

Tierlieb: Created page with "'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. TOC == The Upsell Widget == The Upsell widget is a widge..."

2013-12-17T15:13:45Z

Created page with "'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. __TOC__ == The Upsell Widget == The Upsell widget is a widge..."

New page

'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite.

__TOC__

== The Upsell Widget ==
The Upsell widget is a widget displayed on the portal. It can show images, text or combinations thereof. A widget can contain several "slides". A click on the widget starts the Upsell Wizard. There can be more than one Upsell Widget (just remember not to annoy your customer with too many!). Upsell widgets can be moved, but not removed from the portal.

== The Upsell Bubbles ==
Upsell bubbles are little popups based on hopscotch, similar to the [[AppSuite:Guided tours|guided tours]]. They show up after a given amount of time and point to a defined UI element to display some text. Clicking on them starts the Upsell Wizard (unless you click "cancel", of course).

== The Upsell Wizard ==
The Upsell Wizard is a small shopping cart application that displays things that can be sold. They process is the usual three-step process of putting items in your cart, reviewing them and ordering them. Upon completion the Wizard calls an URL with the ordered items as well as the shoppers's ID and context number. It is left to the provider to implement some handler for that.

== Making all of it work ==
The configuration for all three elements is done in YAML instead of JavaScript, assuming that most users of this feature are not developers but from marketing or sales departments. They will probably need starting help from a sysadmin, though, as by default, the whole Upsell process is disabled two-fold:
* The configuration file is not deployed. To do so, one needs to create one in the settings subfolder of the server configuration. This is usually /opt/openexchange/etc/settings. And example can be found in the UI folder as upsell-examples.yml
* The capability is not enabled. It is called "upsell" and, well, needs to be enabled.

After that, a server restart (necessary for every config change, sorry!) and some hard refreshing to get rid of eventual caching artefacts, you are good to go!

[[Category:AppSuite]]
[[Category:Sales]]
[[Category:Administrator]]

AppSuite:Upsell tools - Revision history

Khgras at 10:26, 12 July 2016

Frank.paczynski at 13:51, 10 February 2016

Tierlieb: /* The Upsell Wizard */

Tierlieb: /* The Upsell Bubbles */

Tierlieb: /* The Upsell Widget */

Tierlieb: /* The Upsell Widget */

Tierlieb at 15:27, 17 December 2013

Tierlieb: Created page with "'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. __TOC__ == The Upsell Widget == The Upsell widget is a widge..."

Tierlieb: Created page with "'''Synopsis:''' This article introduces several ways of promoting applications and other upgrades for App Suite. TOC == The Upsell Widget == The Upsell widget is a widge..."