WP-Polls

Hỏi đáp

General Usage (Without Widget)

<?php if ( function_exists( 'vote_poll' ) && ! in_pollarchive() ): ?>
    <li>
        <h2>Polls</h2>
        <ul>
            <li><?php get_poll();?></li>
        </ul>
        <?php display_polls_archive_link(); ?>
    </li>
<?php endif; ?>

• To show specific poll, use <?php get_poll(2); ?> where 2 is your poll id.
• To show random poll, use <?php get_poll(-2); ?>
• To embed a specific poll in your post, use [poll id="2"] where 2 is your poll id.
• To embed a random poll in your post, use [poll id="-2"]
• To embed a specific poll’s result in your post, use [poll id="2" type="result"] where 2 is your poll id.

General Usage (With Widget)

1. Go to WP-Admin -> Appearance -> Widgets.
2. You can add the Polls Widget by clicking on the ‘Add’ link besides it.
3. After adding, you can configure the Polls Widget by clicking on the ‘Edit’ link besides it.
4. Click ‘Save Changes’.
5. Scroll down for instructions on how to create a Polls Archive.

How To Add A Polls Archive?

1. Go to WP-Admin -> Pages -> Add New.
2. Type any title you like in the post’s title area.
3. If you ARE using nice permalinks, after typing the title, WordPress will generate the permalink to the page. You will see an ‘Edit’ link just beside the permalink.
4. Click ‘Edit’ and type in pollsarchive in the text field and click ‘Save’.
5. Type [page_polls] in the post’s content area.
6. Click ‘Publish’.

• If you ARE NOT using nice permalinks, you need to go to WP-Admin -> Polls -> Poll Options and under Poll Archive -> Polls Archive URL, you need to fill in the URL to the Polls Archive Page you created above.

Why doesn’t my poll’s answers add up to 100%?

• It is because of rounding issues. To make it always round up to 100%, the last poll’s answer will get the remainding percentage added to it. To enable this feature, add this to your theme’s functions.php: add_filter( 'wp_polls_round_percentage', '__return_true' );

How Does WP-Polls Load CSS?

• WP-Polls will load polls-css.css from your theme’s directory if it exists.
• If it doesn’t exists, it will just load the default polls-css.css that comes with WP-Polls.
• This will allow you to upgrade WP-Polls without worrying about overwriting your polls styles that you have created.

Why In Internet Explorer (IE) The poll’s Text Appear Jagged?

• To solve this issue, Open poll-css.css
• Find: /* background-color: #ffffff; */
• Replace: background-color: #ffffff; (where #ffffff should be your background color for the poll.)

How Do I Have Individual Colors For Each Poll’s Bar?

• Courtesy Of TreedBox.com
• Open poll-css.css
• Add to the end of the file:

.wp-polls-ul li:nth-child(01) .pollbar{ background:#8FA0C5}
.wp-polls-ul li:nth-child(02) .pollbar{ background:#FF8}
.wp-polls-ul li:nth-child(03) .pollbar{ background:#ff8a3b}
.wp-polls-ul li:nth-child(04) .pollbar{ background:#a61e2a}
.wp-polls-ul li:nth-child(05) .pollbar{ background:#4ebbff}
.wp-polls-ul li:nth-child(06) .pollbar{ background:#fbca54}
.wp-polls-ul li:nth-child(07) .pollbar{ background:#aad34f}
.wp-polls-ul li:nth-child(08) .pollbar{ background:#66cc9a}
.wp-polls-ul li:nth-child(09) .pollbar{ background:#98CBCB}
.wp-polls-ul li:nth-child(10) .pollbar{ background:#a67c52}
.wp-polls-ul li .pollbar{ transition: background 0.7s ease-in-out }
.wp-polls-ul li .pollbar:hover{ background:#F00 }

To Display Total Polls

<?php if ( function_exists( 'get_pollquestions' ) ): ?>
    <?php get_pollquestions(); ?>
<?php endif; ?> 

To Display Total Poll Answers

<?php if ( function_exists( 'get_pollanswers' ) ): ?>
    <?php get_pollanswers(); ?>
<?php endif; ?> 

To Display Total Poll Votes

<?php if ( function_exists( 'get_pollvotes' ) ): ?>
    <?php get_pollvotes(); ?>
<?php endif; ?> 

To Display Poll Votes by ID

<?php if ( function_exists( 'get_pollvotes_by_id' ) ): ?>
    <?php get_pollvotes_by_id($poll_id); ?>
<?php endif; ?>

To Display Total Poll Voters

<?php if ( function_exists( 'get_pollvoters' ) ): ?>
    <?php get_pollvoters(); ?>
<?php endif; ?> 

To Display Poll Time by ID and date format

<?php if ( function_exists( 'get_polltime' ) ): ?>
    <?php get_polltime( $poll_id, $date_format ); ?>
<?php endif; ?>

Translating the template

The plugin templates can be translated via template variables.
There are these filters for the custom template variables

wp_polls_template_votebody_variables
wp_polls_template_votefooter
wp_polls_template_resultheader_variables
wp_polls_template_resultbody_variables
wp_polls_template_resultfooter_variables

Add filter to your theme and register custom variable where you will add your translation.
Good practice is to name them for example with prefix STR_ in the example STR_TOTAL_VOTERS.

    /**
     * Localize wp_polls_template_resultfooter_variables.
     *
     * @param array $variables An array of template variables.
     * @return array $variables Modified template variables.
     */
    function wp_polls_template_resultfooter_variables( $variables ) {

        // Add strings.
        $variables['%STR_TOTAL_VOTERS%'] = __( 'Total voters', 'theme-textdomain' );

        return $variables;
    }

// Trigger the filter
add_filter( 'wp_polls_template_resultfooter_variables', 'wp_polls_template_resultfooter_variables' , 10, 1 );

In the admin side just call the custom variable like so and the variable has been translated in the front-end.
%STR_TOTAL_VOTERS%’