The Applicant Portal can be customized within Fountain to include some powerful features critical for applicant retention and engagement. By customizing your brand and understanding these tools, you can create an Application Form that will attract more applicants!
What's Covered
iFrame
An iFrame is a window inside a window. It can be added on to any stage using html, and it is commonly used to have applicants sign a terms and conditions and show applicants the company website.
To add an iFrame:
- Under Stage Body, click Use code editor.
-
Note: Whitelisted Sites
The sites that can be put into an iframe are: youtube (via embed code in video link share), vimeo, slideshare, google drive, dropbox, and screencast.
Javascript
Additional Custom Scripts can be added to each stage for additional customization.
To add a Custom Script:
- Under Custom Scripts, choose whether you want the Javascript to be executed when an applicant lands on the stage or after they complete the stage.
- Insert the Custom Script.
Hide Stage from Applicant Portal
In Company Settings > Company > Applicants, there is an option that to Make all stages in an opening visible to the applicants in their applications. This means that the application will have a list of all the stages on the left-hand side, as well as a progress bar showing the applicant's percentage through the application. You can only hide a stage from the Applicant Portal if this is allowed.
Best Practice
We recommend that you enable Make all stages in an opening visible to the applicants in their applications to ensure that the applicants know how much time the application will take.
Hiding a stage from the Applicant Portal progress tracker means that that specific stage will not be shown on the left sidebar. To do so, go to the stage you want to hide. Under Advanced Settings, toggle off Show stage in applicant portal progress tracker.
Changes in AX2.0
Our redesigned applicant experience (AX 2.0) has a fully overhauled, modernized user interface that fundamentally functions differently than 1.0.
As a result, a handful of customers have experienced breakages due to customizations applied to their openings via custom scripts. Scripts that depend on page events or reference anything in the webpage outside of custom scripts will no longer work.
Note
Most uses of custom scripts do neither and likely are NOT broken.Technical Detail
The biggest structural change Fountain implemented for AX 2.0 was updating the UI code architecture from Server Side Rendered (SSR) to Single Page Application (SPA). This means that Fountain styles (CSS) and structural elements (HTML) in the page have completely changed.
Additionally, custom scripts are now executed at a different point in time by the browser in AX2.0 vs. 1.0.
Below is a list of code examples that may result in breakages when using AX 2.0. Click the tabs below to review the troubleshooting steps to resolve.
If you are using Fountain's internal CSS, you may have a styling breakage related to your customization. This is because it is likely the CSS class referenced in the script is no longer available.
Follow these steps to fix the breakage:
-
Inspect the correctly working HTML element in AX1.0 to see what classes were being used within it.
-
Find the equivalent HTML element in AX2.0.
-
Determine a method for applying styles to the new element. Reach out to your CSM or support@fountain if you need assistance.
Please note, Fountain's CSS classes are dynamically hashed and prone to change. Since class hashes are prone to change, referencing them should be avoided since they are an unreliable means to reference an element.
In AX2.0, document load events run before custom scripts are injected into the page. Custom script code that references these events will not function properly.
If a breakage occurs, reduce the scripts to include only the code inside the event callback. This will likely solve the breakage because the code will run immediately upon injection.
If encountered, Fountain advises you to prefer document.body.appencChild or a similar modern equivalent instead of document.write.
Most instances of iframes should still work in AX 2.0. If you have issues, please reach out to your CSM or support@fountain.com for assistance.
If you see something like gon.[...], the script is probably not functioning properly. References to gon must be removed.
Comments
0 comments