Use an Inline Visualforce Page with Standard Page Layouts

Let's face it, using standard page layouts is easy. Throw some field on the page, arrange some related lists and then essentially forget about the page. However, if you really need to customize the user experience you are almost always forced to write a custom Visualforce page that may require maintenance in the future. But what if you just want to tweak the page layout and give it a little Visualforce bling? Perhaps a custom related list from multiple objects, a Flickr mashup or a Google map of your canary's current location?

You can now add Visualforce pages to stardard page layouts basically in the same way you can S-Controls. The use case is that you have accounts with hundreds of opportunities each and users are getting tired of scrolling through pages and pages of records to find the ones that they need. Let's develop a Visualforce page and controller extension that provides them with a opportunity search interface on the account details page.

Here's what the final application looks like:


First we need to create the Visualforce page and controller extension. Our Visualforce page must use the standard Account controller or it will not show up on the list of available Visualforce pages on the page layout.


public class OpportunitySearchController {

  //added an instance varaible for the standard controller
  private ApexPages.StandardController controller {get; set;}
  // the actual account
  private Account a;
 // the results from the search. do not init the results or a blank rows show up initially on page load
  public List<opportunity> searchResults {get;set;}

 // the text in the search box
  public string searchText {
   get {
    if (searchText == null) searchText = 'Acme'; // prefill the serach box for ease of use
    return searchText;

  public OpportunitySearchController(ApexPages.StandardController controller) {

  //initialize the stanrdard controller
  this.controller = controller;
  this.a = (Account)controller.getRecord();


 // fired when the search button is clicked
 public PageReference search() {
  if (searchResults == null) {
   searchResults = new List<opportunity>(); // init the list if it is null
  } else {
   searchResults.clear(); // clear out the current results if they exist
  // Note: you could have achieved the same results as above by just using:
  // searchResults = new List<categoryWrapper>();

  // use some dynamic soql to find the related opportunities by name
  String qry = 'Select o.Id, o.Name, o.StageName, o.CloseDate, o.Amount from Opportunity o Where AccountId = ''+a.Id+'' And o.Name LIKE '%'+searchText+'%' Order By o.Name';
  searchResults = Database.query(qry);
  return null;



<apex:page standardController="Account" extensions="OpportunitySearchController">
 <style type="text/css">
  body {background: #F3F3EC; padding-top: 15px}

 <apex:form >
  <apex:pageBlock title="Search for Opportunities by Keyword" id="block" mode="edit">
   <apex:pageMessages />

   <apex:pageBlockSection >
    <apex:pageBlockSectionItem >
     <apex:outputLabel for="searchText">Keyword</apex:outputLabel>
     <apex:panelGroup >
     <apex:inputText id="searchText" value="{!searchText}"/>
     <apex:commandButton value="Search" action="{!search}" rerender="resultsBlock" status="status"/>
   <apex:actionStatus id="status" startText="Searching... please wait..."/>
   <apex:pageBlockSection id="resultsBlock" columns="1">
    <apex:pageBlockTable value="{!searchResults}" var="o" rendered="{!NOT(ISNULL(searchResults))}">
    <apex:column headerValue="Name">
      <apex:outputLink value="/{!o.Id}">{!o.Name}</apex:outputLink>
     <apex:column value="{!o.StageName}"/>
     <apex:column value="{!o.Amount}"/>
     <apex:column value="{!o.CloseDate}"/>


Now all you simply have to do is add this new Visalforce page to your page layout and you're a hero!