Merge pull request #124 from inplayer-org/donation-paywall-methods-addition-patch-1

Update paywall3.md

Author: matejpetrov

docs/paywall3.md

@@ -457,6 +457,17 @@ Example:
     paywall.isAuthenticated();
 ```
 
+### `showDonationsFlow`
+
+This method initiates the donation flow for the provided `assetId`. The donation flow lists all donation options added to the asset that is being accessed. 
+
+Example:
+
+```js
+    paywall.showDonationsFlow(assetId);
+```
+
+
 ### Asset Manipulation Methods
 
 The Paywall 3.0 increases flexibility by introducing methods that help you easily manipulate with adding or removing specific or all assets to/from a paywall instance. Also, aids optimization of created paywall instances by giving you the choice of destroying those that are most likely not to be used in the recent future.
@@ -691,14 +702,25 @@ Although you may use the paywall's JavaScript methods to invoke some of the func
 
 Here is the list of the HTML classes that can be used for creating each of the standalone functionalities: 
 
-| HTML class	|   Description |
+| HTML class	|   Description | 
 |--------------|---------------|
-| `inplayer-paywall-login`	| Invokes the login screen of the paywall |
-| `inplayer-paywall-logout`	| Invokes the logout action  |
-| `inplayer-paywall-account`	 | Invokes the 'My Account' screen of the registered user |
-| `inplayer-paywall-ccm`      | Invokes the  default card management screen |
-| `inplayer-paywall-change-pass`  | Invokes the 'Change Password' screen |
-| `inplayer-paywall-purchases`  | Invokes the 'My Purchases' paywall screen where an end-user can see the list of payments they have completed |
+| `inplayer-paywall-login`	| Invokes the login screen of the paywall | 
+| `inplayer-paywall-logout`	| Invokes the logout action  | 
+| `inplayer-paywall-account`	 | Invokes the 'My Account' screen of the registered user | 
+| `inplayer-paywall-ccm`      | Invokes the  default card management screen | 
+| `inplayer-paywall-change-pass`  | Invokes the 'Change Password' screen | 
+| `inplayer-paywall-purchases`  | Invokes the 'My Purchases' paywall screen where an end-user can see the list of payments they have completed | 
+| `inplayer-paywall-donations`	| Invokes the donations flow for the provided asset. See below for example of usage  | 
+
+
+The HTML class **inplayer-paywall-donations** can be added to any HTML element. The `asset-id` represents the ID of a specific InPlayer asset. Usage example:
+
+```
+<button class="inplayer-paywall-donations" data-asset-id="{asset-id}" />
+```
+
+When clicking on this element, the donations flow for the provided asset is initiated by opening the donation options screen. 
+The donation options screen lists all donation options added to the asset that is being accessed. After selecting a donation option the end-user can proceed with the donation payment.
 
 The advantage of using these classes is that they come with a built-in logic for displaying and hiding the elements, depending on whether the user is authenticated or not. For example, the HTML element with the **inplayer-paywall-logout class** will only be shown when the user is authenticated.
 
@@ -750,6 +772,7 @@ Here are listed and defined the Paywall 3.0 standalone functions:
 
 Table 4
 
+
 ## Custom Asset Preview
 
 There's a default asset preview template that you can tweak via our dashboard but if that doesn't meet your custom needs, you can always use the `noPreview` flag (by setting it to `true`) to disable displaying of the default preview altogether and put your own preview HTML code in the asset div.