Activate

1. Open the downloaded zip file
2. If you’re using Wordpress 2.3, extract the contents of the Version1.0 folder to your Wordpress plugins folder; if you’re using Wordpress 2.5 or 2.6, extract the contents of the Version1.1 folder
3. Activate the Proxy Vote plugin
4. Go to the Settings page (Options in WP 2.3); select the Create Tables button.
5. Activation is complete, so create a proxy event.

The Events Management View

The Events Management View shows a list of all proxy events and the form for creating a new event. Events with the nearest expiration time are shown on the top. The number of proxies generated and submitted are displayed.

Each event has two selections: Edit and Delete. Selecting Delete will open a dialog box which allows you to proceed or cancel the action. Selecting Edit brings you to the next screen which displays proxy details.

The Proxy Details View

This view shows actions relevant to the current event. All actions are display in the top section called “Activities”. Let’s briefly review each one.

• The first bullet shows the activation string necessary to insert the proxy form into a post or page. You can type or copy the text displayed. It will always follow the pattern [proxyID] where ID is the id number of the proxy event. If you insert this text with an invalid id number, the plugin will ignore the text.
• The second bullet provides a link to the Proxy Message View.
• The third bullet links to the Proxy Results View.
• The fourth bullet links to the bottom of the page where you can update properties of the event, such as title, description, and expiration time.
• Finally, the last bullet links to the Proxy XML View.

The Proxy Message View

The proxy message is the keystone of the Proxy Vote plugin. You can use the proxy message for a variety of purposes, but its main intent is to provide a custom message to each voter with a unique proxy key. In the Proxy Message View, you can preview what these messages will look like. At the top of the screen you will see a message box which provides some tips on printing the proxy message. If you have 300 voters, you should have 300 proxy messages. For almost all web browsers, you will proceed to File -> Print Preview menu item. Verify your description has been formatted the way you intended.

The Proxy Results View

Proxy results include all the submitted proxies for the event. Much like the Proxy Message, the print preview feature of your web browser will format the page. In most circumstances, the landscape page format is superior for tabular data. This view is display only.

In the table you will find these columns:

• Key is the 10-character random code distributed to this voter.
• Voter is the person submitting the proxy.
• Proxy is the person who will vote on behalf of the voter.
• IP is the internet protocol address of the computer which submitted the proxy.
• Submit Time is when the proxy information was submitted to your site.

The Proxy XML View

This view displays all event data in XML format. The proxy event can be exported to a file using the Export to XML File button. The auto-generated name will be exportID.xml where ID is the id number of the proxy event. Although the data is displayed in a text editable field, you cannot change the data here.

Create an Event

1. Go to the Manage tab, then select Proxy Votes.
2. Enter your event information under the section “Add Proxy Event”
• Title can be anything meaningful to identify this event. You can update the Title at any time.
• Description can contain actual HTML code; line breaks, headings, images, tables, or anything you need to summarize the event. However, it should always contain the [key] and [expires] tag. The Description section forms the text of your proxy message, which is a custom set of instructions to your voter. It should also provide the URL of the proxy form. It’s a good idea to create a draft of the post so you can finalize your proxy message. You can update the Description at any time.
• Expiration is the local end time for the proxy event. The plugin will not accept proxies submitted after the expiration. The expiration time uses the properties setup in your blog, such as the UTC offset. You can update the Expiration at any time.
• Number of Voters is the maximum number of people who can submit a voter proxy. This value cannot be changed once the event is created.
3. Select Add Event and you will see a message which confirms the event was created and the random keys generated.

Sample Proxy Message

The following snippet of HTML code is a good starting point for your proxy message. It doesn’t contain any image links. However, it makes use of embedded styles, unordered lists, and those two important tags: [key] and [expires].

<h1>The Proxy Event</h1> <p>This is the proxy event you've waited for all year. To achieve a quorum at our annual meeting, we only ask for a few moments of your time. This year we've made the process of submitting a proxy easier than ever. Please follow these directions carefully.</p> <ol> <li>Go to our website: www.unsaturated.com/proxyvote</li> <li>Look for entry titled "Proxy Event of the Year"</li> <li>In the first space you will notice the expiration date, which is currently [expires]. You must submit your proxy before that time.</li> <li>In the next space enter your unique code: <b>[key]</b></li> <li>Enter your name (last name, first name)</li> <li>Enter your proxy's name (last name, first name)</li> </ol> <p>Again, we thank you for your support. This will help our meeting proceed smoothly and ensure business continues without any further delays.</p> <p>Sincerely,<br/> Matthew Crumley<br/> Board President</p>

This entry was posted on Saturday, September 20th, 2008 at 11:01 PM and is archived under Proxy Vote. You can follow comments to this entry through the RSS 2.0 feed. You can leave a comment or trackback from your own site.