Skip to content

Latest commit

 

History

History
55 lines (38 loc) · 3.04 KB

README.md

File metadata and controls

55 lines (38 loc) · 3.04 KB

Visualforce-PlatformShiv

Easily create Visualforce pages that are compatible with Salesforce Classic, Salesforce1, and Lightning Experience

The unmanaged package can be downloaded directly into Salesforce at https://goo.gl/oax19L. Otherwise, the manual installation instructions are below.

Instructions:

  1. Download the PlatformShivJSBundle.zip.
  2. Create a Static Resource named PlatformShivJSBundle
  3. Create a new Visualforce page.
  4. Include a reference to the JavaScript and CSS files you downloaded:

<apex:includeScript value="{!URLFOR($Resource.PlatformShivJSBundle, 'jquery.js')}"/>
<apex:includeScript value="{!URLFOR($Resource.PlatformShivJSBundle, 'PlatformShivJS.js')}"/>
<link href="{!URLFOR($Resource.PlatformShivJSBundle, 'PlatformShivJS.css')}" rel="stylesheet"/>

  1. Access the Visualforce Global Variable to determine which platform is in use and initialize the shiv:

<script>
  var $j = jQuery.noConflict();
  var theme = '{!$User.UIThemeDisplayed}';
  $j(document).ready(function () {
     PlatformShivJS.init(theme);
  });
</script>

To create a link to a record detail page:

Use a placeholder "href" attribute. The shiv will populate this based on the platform in use. Add the record ID in the "data-id" attribute, add the object name to the "data-object" attribute, and use the class "viewLink":

<a href="#" data-id="{!a.Id}" data-object="Account" target="_blank" class="viewLink">Details</a>

To create a link to edit a record:

Use a placeholder "href" attribute. The shiv will populate this based on the platform in use. Add the record ID in the "data-id" attribute, add the object name to the "data-object" attribute, and use the class "editLink":

<a href="#" data-id="{!a.Id}" data-object="Account" target="_blank" class="editLink">Edit</a>

To include/exclude elements based on platform:

For instance, if you want to pre-polulate an Account Name when creating the record. This was done with URL parameters in Salesforce Classic, but Actions are used in Salesforce1 and Lightning Experience. You can use the "onlyClassic" class on such an element and the JavaScript will hide it for other platforms.

Available classes are:

notClassic
notLightning
notMobile
onlyClassic
onlyLightning
onlyMobile
classicOnly
lightningOnly
mobileOnly