Installing the Plugin Code

Please note that the information below is not strictly necessary. When Support creates a new system in VoterVoice, we always also create a wrapper / hosted page on our end that can serve as the public portal through which your supporters can utilize the VoterVoice software. Many clients prefer to use the plugin option instead because it imports the VoterVoice content into their page and thus allows them more control over the look and feel while keeping the supporters on their domain. 

Our VoterVoice Action Center Plugin enables you to plug the VoterVoice content into a page on your website. This allows you to maintain control over your page and provides the flexibility for you to edit anything surrounding our content. Most associations create a page on their website dedicated to the VoterVoice content called ‘Action Center’ or something similar.

Additional Requirements

Javascript

Using the plugin code to import the VoterVoice content onto your site requires that your CMS allows the use of javascript and allows you to be able to edit the html of your pages' content. This means that it does not work for WIX, Google Sites, the free version of WordPress, or the lowest levels of Squarespace. If you are not able to add javascript or edit HTML, VoterVoice will have to host the Action Center for you. The redirection to specific tools / actions will not work without javascript.

Background Color

The VoterVoice content is specifically designed to be displayed on pages with light backgrounds. If you want to install it on a page with a dark background, you will need to reach out to [e-mail] for assistance with back-end styling to ensure legibility.

Before installing the plugin, you will need to decide which of the plugin codes to use. 

Follow these steps to set up one of those plugin codes:

1) Get the Plugin Code

1. Log in to the VoterVoice admin site.

2. Click the profile icon (the green circle with your initials) in the top-right corner.

3. Select Settings, then choose Action Center.

4. On the Action Center Settings page, click the Site Settings tab.

Within this tab, you will see the Plugin Codes section.

5. Use the Feature dropdown to choose which tool you would like to be the default view.

• If you select a tool with individual actions (such as Campaigns), you may also choose a specific default campaign.

6. After making your selections, copy the provided embed code. This is the plugin code you will paste into your CMS.

2) Install the Code

1. Open your website editor and navigate to the page where you want the VoterVoice content to appear.

2. Ensure the page title is generic enough to host any type of VoterVoice content (campaigns, surveys, petitions, bill search, etc.).

3. Make sure the plugin content will appear above the fold, so users see it immediately when the page loads.

4. Paste the plugin embed code followed immediately by:

   <vv:main></vv:main>

   into the HTML of the content area, then save the page.

If you do not know how to edit the HTML or see only the code and not the actual content, please contact your website platform’s support team for assistance.

⚠️ Important:
Place only one plugin code on your Action Center page. If multiple instances are added, any votervoice.net link will cause all instances to display the same content.

3) Set the Redirection URL in VoterVoice

1. Return to the Site Settings tab of the Action Center Settings page where you retrieved the plugin code.

2. Locate the field labeled Your Website Action Center URL.

3. Paste the URL of the page where you installed the plugin code.

4. Click the Publish Site Settings button (top-right corner) to save your changes.

Once saved, any of the votervoice.net links listed here will redirect to your URL and show only the requested content. 

Click here for information about styling the VoterVoice content.