CodeNewbie Community šŸŒ±

Dorian Sabitov
Dorian Sabitov

Posted on • Originally published at sfapps.info on

All Types of Visualforce Page Customizations Explained

Introduction: Why Do You Need a Visualforce

Salesforce Visualforce is one of the early and most powerful tools in Salesforce for creating customized user interfaces. Whether youā€™re building a simple page or a complex interactive dashboard, Visualforce offers a flexible framework to tailor the Salesforce experience to your organizationā€™s specific needs. Itā€™s not just about aesthetics, itā€™s about enhancing user experience, improving efficiency, and optimizing workflows to better align with business objectives.

As stated in the official documentation, Visualforce is a framework that can be hosted natively on Lightning Platform, includes a tag-based markup language similar to HTML, and has a set of server-side ā€œstandard controllersā€ that make basic database operations, such as queries and saves, simple to perform. Visualforce is available for desktop browsers, in both Lightning Experience and Salesforce Classic, and in the Salesforce mobile app.

By leveraging Visualforce Pages with Custom Controllers, Apex, and other techniques, developers can tackle unique challenges, streamline processes, and extend Salesforceā€™s functionality beyond its out-of-the-box capabilities.

Types of Visualforce Customizations

This article will delve into various types of Visualforce Page customizations, starting with the more significant functional ones and ending with simple UI enhancements, offering practical examples and actionable steps for Salesforce professionals at any level. And if you are just starting to get acquainted with Salesforce technologies, you may find the material about Salesforce administrator salary useful.

Custom Controllers

Custom Controllers in Salesforce are Apex classes that developers use to extend or replace the standard functionality provided by built-in controllers for Visualforce Pages.

While standard controllers allow for basic CRUD operations, Custom Controllers offer far greater flexibility and control. Custom Controllers are the most important element of functional customization for Visualforce Pages.

They enable developers to write their own logic for how data is retrieved, displayed, and manipulated on a Visualforce Page.

This added level of customization is especially useful for tailoring user interactions to specific business processes, handling complex data scenarios, and implementing advanced business logic.

Now that we understand the usefulness of Custom Controllers, letā€™s look at some Visualforce Page with a Custom Controller example and its implementation.

Creating a Simple Custom Controller to Receive and Display Data

Letā€™s start with a simple example, in which we will show how to create a Visualforce Page with a Custom Controller. In this case, the Š”ontroller will take the names of the first 10 accounts from our Salesforce org database and display them on the Visualforce Page. For this we create a new Custom Controller with corresponding code and Visualforce Page with appropriate markup.

Step 1. Open Developer Console, a simple tool for creating Apex Classes and Visualforce Pages.

Open Developer Console
Open Developer Console

Step 2. Create a new Apex Class file in which we will create our Custom Controller.

Creating a new Apex Class file
Creating a new Apex Class file

Step 3. Name the new Apex Class file.

Naming a new Apex Class file
Naming a new Apex Class file

Step 4. Š”reate and save a Custom Controller, that finds 10 Accounts from our org.

Fill the Custom Controller file with code
Fill the Custom Controller file with code

Step 5. Create a new Visualforce Page, that will display the data collected by the previously created Custom Controller.

Creating a new Visualforce Page file
Creating a new Visualforce Page file

Step 6. Name the new Visualforce Page.

Naming a new Visualforce Page file
Naming a new Visualforce Page file

Step 7. Š”reate and save a Visualforce Page that calls the Custom Controller SFAppsCustomControllerSimple, which contains logic to retrieve the first 10 accounts from the Salesforce Organization, or just Org.

Fill the Visualforce Page file with markup
Fill the Visualforce Page file with markup

The configuration is finished. Now we can view the page we created. Go to Setup:

Where to preview Visualforce Pages
Where to preview Visualforce Pages

And here it is, our Visualforce Page that obtains information from the Custom Controller:

Visualforce Page with result from simple Custom Controller preview
Visualforce Page with result from simple Custom Controller preview

In this example, we looked at the process of creating a Visualforce Page and integrating it with a simple Custom Controller design, which can easily be modified to include more complex requirements.

Advanced Examples of Custom Controller

Letā€™s take a look at an example of a more advanced Custom Controller, without going through the detailed procedure for creating Visualforce Page and Apex Class files that we described above.

We will create two examples of advanced Custom Controller and custom Visualforce Page to update object values and to create object records in Salesforce org.

Creating an Advanced Custom Controller to Update Object Values

In this case we create a Visualforce Page that will have two buttons and use the Custom Controller to make and remove changes to Account names in the Salesforce Org.

Step 1. Create a more advanced Custom Controller.

Advanced Custom Controller code example 2
Advanced Custom Controller code example

Step 2. Create a Visualforce Page.

Visualforce Page markup with Custom Controller example 1
Visualforce Page markup with Custom Controller example

Now letā€™s see a preview of what the newly created Visualforce Page example with a Custom Controller looks like:

Visualforce Page with advanced Custom Controller preview
Visualforce Page with advanced Custom Controller preview

If we click on the ā€œAdd Update Accountsā€ button, this Visualforce Page will contact our advanced Custom Controller, which will make a change to the Account name and write this change to the Salesforce Org.

Visualforce Page with the result of clicking the Add Update Accounts button
Visualforce Page with the result of clicking the Add Update Accounts button

Salesforce Org Accounts tab with changed Account names
Salesforce Org Accounts tab with changed Account names

If we click on the ā€œDelete Update Accountsā€ button, this Visualforce Page will contact our advanced Custom Controller, which will delete the word ā€œ- Updatedā€ from both the Visualforce Page and the Salesforce Org database.

Creating an Advanced Custom Controller to Create Object Records

For this case we create a custom registration Visualforce Page in the Salesforce Org, that allows us to create records of the Account object.

Step 1. Create a Custom Controller.

Advanced Custom Controller code example 1
Advanced Custom Controller code example

Step 2. Create a Visualforce Page.

Visualforce Page markup with Custom Controller example 2
Visualforce Page markup with Custom Controller example

Open the preview of the created Visualforce Page:

Visualforce Page with fillable fields
Visualforce Page with fillable fields

Fill in the fields, click the ā€œRegisterā€ button, and receive a message confirming the successful registration of the new record:

Visualforce Page with filled fields and a message about successful registration
Visualforce Page with filled fields and a message about successful registration

Now, if we look in our Salesforce Org, we will see a successfully created new Account object record:

Screenshot from Salesforce Org confirming the creation of the record
Screenshot from Salesforce Org confirming the creation of the record

Use Cases for Custom Controllers

Custom Controllers in Salesforce are particularly valuable when standard controllers fall short of meeting specific business requirements. They offer a wide range of applications, some key use cases include:

  1. Handling Dynamic Data : Custom Controllers enable developers to retrieve and manipulate data dynamically based on user actions or input, providing a more responsive and interactive user experience.
  2. Implementing Complex Logic : When business processes demand sophisticated data manipulation or decision-making, Custom Controllers allow developers to write and execute the necessary complex logic.
  3. Optimizing User Interactions : Advanced features like dynamic field updates, filtering, and Pagination can be implemented without full page reloads, resulting in smoother and more efficient user experiences.
  4. Multi-Object Operations : Custom Controllers excel at implementing business logic that involves interactions with multiple Salesforce objects, allowing for more comprehensive data management.
  5. Creating Tailored User Interfaces : Developers can design and implement custom UIs that require specific data manipulations, meeting unique organizational needs.
  6. External System Integration : Custom Controllers facilitate integration with external systems or APIs, expanding the capabilities of Salesforce applications.

Pagination

Managing large data sets in Visualforce Pages can be challenging due to performance issues and governor limits in Salesforce. Without proper handling, pages can become slow and unresponsive, leading to a poor user experience. Creating a custom Pagination Visualforce Page for 50,000 records, which is the maximum number of records that can be retrieved in a single SOQL query, is crucial for managing large data sets efficiently. Pagination allows you to divide the data into smaller chunks, which improves page load time and enhances user experience.

Letā€™s look at an example of Pagination implementation. To do this, create a Custom Controller and a Visualforce Page.

Custom Controller code with Pagination
Custom Controller code with Pagination

Visualforce Page markup with Pagination
Visualforce Page markup with Pagination

Now letā€™s look at the result, a preview of the Visualforce Page with Pagination implementation.

Visualforce Page with Pagination First page
Visualforce Page with Pagination: First page

When we click on the ā€œNextā€ button, the Visualforce Page will call our Custom Controller and use the nextPage method to display the next set of Accounts.

Visualforce Page with Pagination Second page
Visualforce Page with Pagination: Second page

Displaying Related Records

Displaying related child records in Salesforce Visualforce Pages is a feature that provides comprehensive data views and illustrates important data relationships. This functionality is particularly valuable when you need to show how child records are connected to their parent objects, giving users a clear picture of data hierarchies and associations.

A common use case for Visualforce Page is to create a list view of related child records for a custom object, to see the full context in one place.

So letā€™s see how the simple implementation looks using the example of Salesforce Opportunity Product related list custom Visualforce Page. The Custom Controller will retrieve the Opportunity ID from the current Opportunity page and display a list of related Products:

Custom Controller code for displaying related records
Custom Controller code for displaying related records

Visualforce Page markup for displaying related records
Visualforce Page markup for displaying related records

Now letā€™s look at the result:

Preview of Visualforce Page
Preview of Visualforce Page

The above is just a simple example of how a Visualforce Page can be used to display related information. In fact, this functionality can be extended many times over to meet the most complex business logic.

Insight:

Use Apex best practices for handling large datasets:

  • SOQL Efficiency: Use LIMIT and OFFSET to control the volume of records returned and avoid fetching all records at once.
  • Governor Limits: Ensure that your queries remain within Salesforceā€™s governor limits, especially the limit of 50,000 records per transaction. Use Pagination to handle large datasets efficiently.
  • Index Fields: Ensure that commonly queried fields are indexed to optimize SOQL query performance.
  • Avoid Complex Queries in Loops: Use a bulkified approach to avoid querying inside loops, as this can lead to performance issues and exceeding governor limits.

If you have datasets so large that they require more than one Salesforce Org, Salesforce provides tools to connect 2 Salesforce orgs productively.

Custom Buttons

Whether itā€™s triggering a specific function, updating records, or redirecting to another page, Custom Buttons enhance the usability of Visualforce Pages by improving workflow efficiency. In this section, weā€™ll explore how in Salesforce add Custom Buttons to a Visualforce Page and troubleshoot common issues.

You have already seen examples of Custom Buttons in the Custom Controllers and Pagination sections. To add and use a Custom Button to a Visualforce Page, you need to do two things:

  1. Define the Button on the Visualforce Page: You can use apex:commandButton or apex:commandLink to create the Button on the page, depending on whether you want to perform an action or navigate to another page.
  2. Bind the Button to an Apex Action: The Button can be wired to an Apex method in the controller that handles the desired functionality, like creating or updating a record.

For example, consider the following configuration, where you can see the Custom Button and Custom Link settings. When clicked, these settings rename the Account on whose Visualforce Page the element is located.

Custom Controller code for Custom Button and Custom Link
Custom Controller code for Custom Button and Custom Link

Visualforce Page markup for displaying Custom Button and Custom Link
Visualforce Page markup for displaying Custom Button and Custom Link

The result is a Visualforce Page, that allows you to change the name of your Account with one click of a Button or Link:

Visualforce Page with Custom Button and Custom Link preview
Visualforce Page with Custom Button and Custom Link preview

Before pressing the Button:

Name of Account before pressing the Button
Name of Account before pressing the Button

After pressing the Button:

Name of Account after pressing the Button
Name of Account after pressing the Button

Possible Issues to Beware

Sometimes developers face problems implementing Custom Buttons, such as the Visualforce Page not showing in Custom Button. This issue can occur for several reasons:

  • Button Not Linked Correctly: Ensure that the Visualforce Page is correctly linked in the button definition under ā€œCustom Buttons and Linksā€ in the Salesforce object setup.
  • Permissions Issues: Check that the user has the necessary permissions to view the Visualforce Page.
  • Page Not Available in Lightning: If using Lightning Experience, verify that the Visualforce Page is enabled for use in Lightning. You may need to set the ā€œAvailable for Lightning Experienceā€ checkbox in the Visualforce Page properties.

Custom Labels

Custom Labels in Salesforce are a powerful feature that allows developers to create multilingual applications and manage dynamic content efficiently. They help in maintaining consistency across the application and make it easier to update text without modifying the code. Custom Labels are particularly beneficial for:

  • Localization: Supporting multiple languages by storing translated text.
  • Maintainability: Centralizing text management, making it easier to update and maintain.

How to Use Custom Labels in Visualforce Page and Apex

Using Custom Labels in Visualforce Pages and Apex is straightforward. Hereā€™s how you can implement them:

Step 1. Creating Custom Labels:

  1. Navigate to Setup > Custom Labels.
  2. Click New Custom Label.
  3. Enter the Label and Value (the text you want to display).
  4. Save the Custom Label.

Creating a Custom Label
Creating a Custom Label

Thus, ā€œSFAppsā€ is the unique name of the Custom Label that youā€™ve defined in Salesforce. For example, if you have a Custom Label for a ā€œSFAppsā€ button, you can define this label and refer to it in multiple Visualforce Pages. This becomes especially useful for multi-language applications where you need to translate the button text.

Step 2. Reference Custom Labels in a Visualforce Page by using the following markup:

Using Custom Label in Visualforce Page markup
Using Custom Label in Visualforce Page markup

And here is the result:

Visualforce Page with Custom Label preview
Visualforce Page with Custom Label preview

In Apex, Custom Labels can be used as follows:

Custom Labels in Apex code
Custom Labels in Apex code

This allows developers to access and use the Custom Label dynamically in their Apex code, making it possible to show localized text or error messages based on different user interactions within the controller logic.

UI Customizations in Visualforce Pages

Beyond functional customizations like Buttons, enhancing the user interface (UI) of Visualforce Pages can significantly improve user engagement and the overall user experience. One such UI enhancement is changing the appearance of tabs or sections within a custom app to reflect your brand or to improve visual consistency.

Techniques for Enhancing the UI of Visualforce Pages

Here are some common techniques and practices for enhancing the UI of your Visualforce Pages:

  1. CSS for Styling : By embedding or referencing custom CSS in your Visualforce Pages, you can override Salesforceā€™s standard styling to implement your own design. This allows for branding consistency across your Salesforce applications.
  2. JavaScript for dynamic UI Changes : JavaScript can be used to add interactivity and dynamic behavior to Visualforce Pages. This includes form validation, dynamic content updates, and enhanced user interactions.
  3. Visualforce Components: Utilize Visualforce components like apex:pageBlock, apex:pageBlockSection, and apex:pageBlockTable to create structured and organized layouts.
  4. Leverage Salesforce Lightning Design System (SLDS): Use SLDS to ensure your Visualforce Pages have a consistent look and feel with Salesforce Lightning Experience.

For example, here is how to change Tab color in custom app Visualforce Page.

To do this, we use simple CSS:

Example of markup for changing Tab color
Example of markup for changing Tab color

Here is the result:

Custom Tab with a modified background color
Custom Tab with a modified background color

Customizing UI elements like tab colors, buttons, and layouts helps in enhancing user experience by providing a visually appealing and intuitive interface.

Salesforce Apps That May Be Useful:

FormAssembly ā€“ this app helps you create custom forms and surveys that can be embedded in Visualforce Pages. It supports complex data collection and integration with Salesforce, enhancing the functionality of your Visualforce Pages.

FormAssembly in AppExchange

Conga Composer ā€“ enables you to generate documents, presentations, and reports from Salesforce data. It can be integrated into Visualforce Pages to provide users with custom document generation capabilities.

Conga Composer Connector in AppExchange

SkyVisualEditor VF ā€“ a user-friendly tool which helps you to easily create custom Salesforce Visualforce Pages with an optimal UI.

SkyVisualEditor VF in AppExchange

Common Challenges and Solutions in Visualforce Customization

A developer has a Visualforce Page and a Custom Controller as effective tools, but they may still face certain challenges. Here are some common issues and solutions:

1. Visualforce Page Not Functioning as Expected

When a Visualforce Page doesnā€™t work as intended, it can stem from multiple issues such as incorrect controller logic, misconfigured components, or data problems. This can lead to pages not loading properly, displaying incorrect data, or failing to execute actions as expected.

Solution: Ensure the Apex controller logic is correct and methods are accessible. Verify that Visualforce components are correctly configured. Check data availability and format.

2. Performance Issues

As data volumes grow, Visualforce Pages can experience slow load times and sluggish performance. This typically happens when handling large datasets or inefficient queries, which can strain system resources and exceed Salesforce governor limits.

Solution: Optimize SOQL queries by using selective queries and avoiding unnecessary fields. Implement pagination for large data sets. Minimize the use of nested components to simplify page structure.

3. Debugging and Troubleshooting Complex Visualforce Pages

Debugging issues within complex Visualforce Pages can be difficult, especially when dealing with multiple components and custom logic. Identifying the root cause of a malfunction requires efficient use of available tools and a structured approach to debugging.

Solution: Use Salesforce tools like Developer Console, debug logs, and Lightning Inspector. Isolate issues, use System.debug(), and check governor limits.

4. Maintaining High Code Quality and Standards

Ensuring that your Visualforce customizations adhere to best practices, both in terms of performance and maintainability, can be challenging without proper procedures in place.

Solution: Regularly review code for best practices and performance. Maintain clear documentation. Implement unit and functional tests. Use version control systems like Git to track changes. Continuously refactor code and stay updated with Salesforce releases.

Looking for professional help with Visualforce Page customization?

Request our admin services!

Explore More

FAQs about Visualforce Page Customizations:

What are Visualforce Pages in Salesforce?

Visualforce Pages are custom user interfaces in Salesforce that allow developers to create tailored solutions using a tag-based markup language similar to HTML. They can be used to build complex, interactive applications that integrate seamlessly with Salesforce data.

How can I implement custom Pagination in a Visualforce Page for 50,000 records?

Custom Pagination helps manage large data sets by loading data in smaller chunks. This involves using Apex controllers to handle SOQL queries with LIMIT and OFFSET clauses, ensuring efficient data retrieval and compliance with Salesforce governor limits.

What are the benefits of using Custom Controllers in Visualforce Pages?

Custom Controllers provide greater flexibility and control over the data and actions available to Visualforce Pages. They allow developers to implement complex business logic, interact with multiple objects, and create highly customized user interfaces.

How do I add custom buttons to a Visualforce Page?

Custom Buttons can be added to Visualforce Pages using apex:commandButton or apex:commandLink tags. These Buttons can trigger specific actions defined in the Apex controller, such as updating records or navigating to different pages.

What are some best practices for maintaining and updating custom Visualforce Pages?

Best practices include conducting regular code reviews, maintaining clear documentation, implementing thorough testing, using version control systems like Git, and continuously refactoring code to improve performance and maintainability. Staying updated with Salesforce releases and leveraging Salesforce administration services can also help optimize customizations.

Conclusion

In this article, we explored various types of Visualforce Page customizations, including the use of custom controllers, handling large data sets with Pagination, adding custom buttons, and leveraging Custom Labels. We also discussed creating custom Visualforce Pages for specific business needs, such as updating object values and building registration pages. However, the topic of Visualforce Customization is quite extensive, given that this technology can be adapted in a wide range of ways. A wide range of Salesforce technologies allows for highly customized user interfaces tailored to specific requirements. Continuous learning and staying updated with Salesforce releases are crucial for leveraging new features and best practices. As your Salesforce needs to grow, consider utilizing Salesforce administration services to ensure your customizations are optimized and aligned with best practices. Experiment with different techniques to meet your unique business challenges.

Additional Resources

  1. Salesforce Visualforce Developer Guide: A comprehensive official guide to Visualforce, covering key concepts, syntax, and best practices.
  2. Apex Developer Guide: This guide provides an in-depth look at Apex, Salesforceā€™s programming language, essential for building custom controllers and extending Visualforce Pages.
  3. Best Practices for Deployments with Large Data Volumes: Techniques and best practices when working with large data sets.
  4. Visualforce Basics on Trailhead: Salesforceā€™s free, interactive learning platform offers a learning path for Visualforce development.
  5. Apex Basics & Database on Trailhead: A great resource for learning how Apex and Visualforce work together to build dynamic web pages.

The post All Types of Visualforce Page Customizations Explained first appeared on Salesforce Apps.

Top comments (0)