Extract Parameters from URL to display Album

It is possible to extract the **SharinPix URL which is assigned as a parameter. **

• Get Parameters inside a Visualforce Page

• Get Parameters inside Lightning Component

Structure of the SharinPix URL

    https://app.sharinpix.com/pagelayout/album_id?token=token_value

From the above sample,

• The whole **SharinPix URL **is passed as a parameter url.

• Within the SharinPix URL,

  • album_id** ** represents the actual value of the album Id.

  • token_value** ** represents the actual token value.

Get Parameters inside a Visualforce Page

• The code snippet below shows how it is possible to use a merge-field to extract the **url **parameter inside a Visualforce Page.

    {!$CurrentPage.parameters.url}

• The code snippet below shows that the extracted url parameter value can be assigned to the **src attribute of an iframe html element ** for displaying the SharinPix Album.

    <apex:page >
        <iframe src="{!$CurrentPage.parameters.url}&annotate={! $CurrentPage.Parameters.annotation}" width="100%" height="500px">
        </iframe>
    </apex:page>

Get Parameters inside Lightning Component

• To extract the value of the parameter **url **inside the markup of a Lightning Component, you will need to define an aura:attribute and assign its **name **attribute with the name of the parameter (in this case, the parameter is url). The type of the aura:attribute is String.

    <aura:attribute name="url" type="String"></aura:attribute>

• To use the value of the extracted value, you will need to use the merge-field as shown below.

    {! v.url }

• The sample code below shows how the extracted value is used to display the **SharinPix Album **inside the markup of a Lightning Component.

    <aura:application >
    	<aura:attribute name="token" type="String"></aura:attribute>
        <iframe src="{! v.token }" width="100%" height="500px"></iframe>
    </aura:application>

Retrieve SharinPix Parameters from a personalized URL

In the following example it will be shown how it is possible to launch SharinPix with the use of a personalized URL. To achieve the latter objective, we will accomplish the following steps:

• Obtain a SharinPix URL

• Create a Visualforce Page that will display the SharinPix Album.

• Create a custom link that will open the Visualforce Page in a new tab.

Obtain a SharinPix URL

• The SharinPix URL should be in the following form:

    https://app.sharinpix.com/pagelayout/album_id?token=token_value

• album_id - corresponds the Salesforce Id of a specific record.

• token_value - the **SharinPix Token. **Refer to the following article to learn how to generate a SharinPix Token : SharinPix automatic token generation (Admin Friendly)

Create a Visualforce Page for SharinPix Album

The following code corresponds to the Visualforce Page that will be implemented. (In this case, this Visualforce Page is named SharinPixParamsDemo).

    <apex:page >
        <iframe src="{! $CurrentPage.Parameters.url }&fullscreen={! $CurrentPage.Parameters.fullscreen }" width="100%" height="500px" style="border: 0;"></iframe>
    </apex:page>

The syntax {! $CurrentPage.Parameters.fullscreen }and {! $CurrentPage.Parameters.url } are used to extract the fullscreen and **url parameter values respectively. **

Create a custom link

• Head over to an Object of your choice and create a new custom link.

• Its **Display Type **is Detail Page Link.

• Its **Behaviour **is Display in new window.

• ** ** Its Content Source is URL.

• In the content editor of the custom link, insert the following URL:

/apex/SharinPixParamsDemo?fullscreen=true&url=https://app.sharinpix.com/pagelayout/album_id?token=token_value&

The above URL starts with** /apex/SharinPixParamsDemo which indicates that it will access a Visualforce Page named SharinPixParamsDemo( as implemented previously) **found in the current Salesforce organization. The **url **parameter value takes the **SharinPix URL **to display the **SharinPix Album. The fullscreen ** parameter value is an arbitrary value (In this case, it is "true ").

Personalize your own URL : The parameter fullscreen ** that takes as value true ** is only meant for illustrative purposes only. You can supply any parameters with the corresponding values of your own choice and use them in the Visualforce Page.

• Next step : Add the custom link to the page-layout of the object.

• Upon clicking on the custom link, the Visualforce Page displays the SharinPix Album and is able to read the parameter value for both url and fullscreen.** **