Changeset 946349

Timestamp:

07/10/2014 04:31:02 PM (12 years ago)

Author:

sutherlandboswell

Message:

Total rewrite for version 3.0

Location:

foursquare-venue

Files:

• assets (added)
• assets/banner-1544x500.png (added)
• assets/banner-772x250.png (added)
• assets/screenshot-1.png (added)
• assets/screenshot-2.png (added)
• assets/screenshot-3.png (added)
• trunk/css (added)
• trunk/css/admin.css (added)
• trunk/foursquare-venue.php (modified) (2 diffs)
• trunk/js (added)
• trunk/js/settings.js (added)
• trunk/php (added)
• trunk/php/class-refactored-settings.php (added)
• trunk/php/widget.php (added)
• trunk/readme.txt (modified) (4 diffs)
• trunk/screenshot-1.png (deleted)
• trunk/screenshot-2.png (deleted)

foursquare-venue/trunk/foursquare-venue.php

@@ -6 +6 @@
 Author: Sutherland Boswell
 Author URI: http://sutherlandboswell.com
-Version: 2.2.2
+Version: 3.0
 License: GPL2
 */
-/*  Copyright 2010 Sutherland Boswell  (email : [email protected])
+/*  Copyright 2014 Sutherland Boswell  (email : [email protected])
 
     This program is free software; you can redistribute it and/or modify
@@ -25 +25 @@
 */
 
-// Set Default Options
-
-register_activation_hook(__FILE__,'foursquare_venue_activate');
-register_deactivation_hook(__FILE__,'foursquare_venue_deactivate');
-
-function foursquare_venue_activate() {
-    add_option('foursquare_venue_client_id','');
-    add_option('foursquare_venue_client_secret','');
-    add_option('foursquare_venue_show_title','');
-    add_option('foursquare_venue_stats_title','Foursquare Stats');
-    add_option('foursquare_show_venue_name','');
-    add_option('foursquare_show_venue_icon','');
-    add_option('foursquare_show_here_now','1');
-    add_option('foursquare_show_here_now_text','');
-    add_option('foursquare_show_total','1');
-    add_option('foursquare_show_total_text','');
-    add_option('foursquare_show_mayor','1');
-    add_option('foursquare_show_mayor_text','');
-    add_option('foursquare_link_mayor','1');
-    add_option('foursquare_show_mayor_photo','1');
-    add_option('foursquare_mayor_photo_size','32');
-    add_option('foursquare_venue_stats_width','');
-    add_option('foursquare_venue_stats_align','');
+// Define
+define( 'FOURSQUARE_VENUE_PATH', dirname(__FILE__) );
+define( 'FOURSQUARE_VENUE_VERSION', '3.0' );
+
+// Includes
+require_once( FOURSQUARE_VENUE_PATH . '/php/class-refactored-settings.php' );
+require_once( FOURSQUARE_VENUE_PATH . '/php/widget.php' );
+
+// Plugin Class
+class Foursquare_Venue_Plugin {
+    
+    function __construct() {
+        /**
+         * Settings
+         */
+        $settings_args = array(
+            'file'    => __FILE__,
+            'version' => FOURSQUARE_VENUE_VERSION,
+            'name'    => 'Foursquare Venue',
+            'slug'    => 'foursquare_venue',
+            'options' => array(
+                'api_key' => array(
+                    'name'        => 'API Key',
+                    'description' => '<a href="https://foursquare.com/developers/apps">Register your app</a> and enter your keys below.',
+                    'fields'      => array(
+                        'client_id' => array(
+                            'name'        => 'Client ID',
+                            'type'        => 'text',
+                            'default'     => '',
+                            'description' => ''
+                        ),
+                        'client_secret' => array(
+                            'name'        => 'Client Secret',
+                            'type'        => 'text',
+                            'default'     => '',
+                            'description' => ''
+                        )
+                    )
+                ),
+                'display' => array(
+                    'name'        => 'Display',
+                    'description' => 'These settings control how the widget and <code>[venue]</code> shortcode are displayed.',
+                    'fields'      => array(
+                        'template' => array(
+                            'name'        => 'Template',
+                            'type'        => 'textarea',
+                            'class'       => 'code',
+                            'default'     => '<a href="%%foursquare_url%%">%%name%%</a><br>' . PHP_EOL . '%%checkins_count%% check-ins<br>' . PHP_EOL . 'Rating: %%rating%%<br>' . PHP_EOL . '%%here_now_summary%%',
+                            'description' => 'To view available placeholders, open the <a href="#" id="open-help-tab">Help</a> tab in the top right.<table class="foursquare-venue-template-preview-table"><tr><th>Preview</th></tr><tr><td><div id="foursquare-venue-template-preview"></div></td></tr></table>'
+                        )
+                    )
+                ),
+            )
+        );
+        $this->settings = new Refactored_Settings_0_4( $settings_args );
+        /**
+         * Add scripts and styles to settings page
+         */
+        add_action( 'admin_init', array( &$this, 'settings_scripts' ), 20 );
+        /**
+         * Add AJAX preview callback for settings page
+         */
+        add_action( 'wp_ajax_foursquare_venue_template_preview', array( &$this, 'template_preview_callback' ) );
+        /**
+         * Add Help tab
+         */
+        add_action( 'load-settings_page_foursquare_venue', array( &$this, 'add_help_tab' ) );
+        /**
+         * Register shortcode
+         */
+        add_shortcode( 'venue', array( &$this, 'venue_shortcode' ) );
+        /**
+         * Delete old settings
+         */
+        $this->delete_old_settings();
+    }
+
+    /**
+     * Deletes pre-3.0 settings
+     */
+    function delete_old_settings() {
+        delete_option('foursquare_venue_client_id');
+        delete_option('foursquare_venue_client_secret');
+        delete_option('foursquare_venue_show_title');
+        delete_option('foursquare_venue_stats_title');
+        delete_option('foursquare_show_venue_name');
+        delete_option('foursquare_show_venue_icon');
+        delete_option('foursquare_show_here_now');
+        delete_option('foursquare_show_here_now_text');
+        delete_option('foursquare_show_total');
+        delete_option('foursquare_show_total_text');
+        delete_option('foursquare_show_mayor');
+        delete_option('foursquare_show_mayor_text');
+        delete_option('foursquare_link_mayor');
+        delete_option('foursquare_show_mayor_photo');
+        delete_option('foursquare_mayor_photo_size');
+        delete_option('foursquare_venue_stats_width');
+        delete_option('foursquare_venue_stats_align');
+    }
+
+    /**
+     * Adds javascript and CSS to the settings page
+     * @return void
+     */
+    function settings_scripts() {
+        wp_enqueue_script( 'foursquare-venue-settings-js', plugins_url( '/js/settings.js' , __FILE__ ), array( 'jquery' ), FOURSQUARE_VENUE_VERSION );
+        wp_enqueue_style( 'foursquare-venue-admin-css', plugins_url( '/css/admin.css', __FILE__ ), false, FOURSQUARE_VENUE_VERSION );
+    }
+
+    /**
+     * The venue shortcode's callback function
+     * @param  array  $atts Shortcode attributes
+     * @return string       The shortcode's HTML
+     */
+    function venue_shortcode( $atts ) {
+        extract(shortcode_atts(array(
+            'id' => '',
+        ), $atts));
+        return $this->render_venue( $id );
+    }
+
+    /**
+     * Renders a venue's info as an HTML string
+     * @param  string $id The Foursquare venue ID
+     * @return string     An HTML string
+     */
+    function render_venue( $id ) {
+        $venue = $this->get_venue( $id );
+        return $this->fill_template( $venue, $this->settings->options['display']['template'] );
+    }
+
+    /**
+     * Callback function for the AJAX call that displays a preview of the venue template
+     */
+    function template_preview_callback() {
+        // Security checks
+        if ( !current_user_can( 'manage_options' ) ) die();
+
+        $template = $_POST['template'];
+        $venue = $this->get_venue( '3fd66200f964a520d6f01ee3' );
+
+        echo $this->fill_template( $venue, $template );
+        die();
+    }
+
+    /**
+     * Fills a template with venue data
+     * @param  object $venue    The venue data retrieved from Foursquare
+     * @param  string $template A template containing placeholders to be filled
+     * @return string           The HTML containing filled in data
+     */
+    function fill_template( $venue, $template ) {
+        if ( is_wp_error( $venue ) ) {
+            $result = $venue->get_error_message();
+        } else {
+            $result = $template;
+            $replacements = $this->get_replacements( $venue );
+            foreach ( $replacements as $key => $value) {
+                $result = str_replace( '%%' . $key . '%%', $value, $result );
+            }
+        }
+        return $result;
+    }
+
+    /**
+     * Gets an array of values available for use in venue templates
+     * @param  object $venue The venue data retrieved from foursquare
+     * @return array         An array of keys available for replacement with real data as the value
+     */
+    function get_replacements( $venue ) {
+        $replacements = array(
+            'id'               => $venue->id,
+            'name'             => $venue->name,
+            'phone'            => $venue->contact->phone,
+            'formatted_phone'  => $venue->contact->formattedPhone,
+            'twitter'          => $venue->contact->twitter,
+            'address'          => $venue->location->address,
+            'cross_street'     => $venue->location->crossStreet,
+            'lat'              => $venue->location->lat,
+            'lng'              => $venue->location->lng,
+            'postal_code'      => $venue->location->postalCode,
+            'cc'               => $venue->location->cc,
+            'city'             => $venue->location->city,
+            'state'            => $venue->location->state,
+            'country'          => $venue->location->country,
+            'foursquare_url'   => $venue->canonicalUrl,
+            'short_url'        => $venue->shortUrl,
+            'website_url'      => $venue->url,
+            'checkins_count'   => $venue->stats->checkinsCount,
+            'users_count'      => $venue->stats->usersCount,
+            'tip_count'        => $venue->stats->tipCount,
+            'likes_count'      => $venue->likes->count,
+            'likes_summary'    => $venue->likes->summary,
+            'rating'           => $venue->rating,
+            'rating_signals'   => $venue->ratingSignals,
+            'here_now_count'   => $venue->hereNow->count,
+            'here_now_summary' => $venue->hereNow->summary,
+            'description'      => $venue->description,
+            'mayor_count'      => $venue->mayor->count,
+            'mayor_id'         => $venue->mayor->user->id,
+            'mayor_url'        => 'https://foursquare.com/user/' . $venue->mayor->user->id,
+            'mayor_first_name' => $venue->mayor->user->firstName,
+            'mayor_last_name'  => $venue->mayor->user->lastName,
+            'mayor_gender'     => $venue->mayor->user->gender,
+            'mayor_photo'      => $venue->mayor->user->photo->prefix . '100x100'. $venue->mayor->user->photo->suffix
+        );
+        return apply_filters( 'foursquare_venue/replacements', $replacements, $venue );
+    }
+
+    /**
+     * Get a venue's data from the Foursquare API or local cache
+     * @param  string $id The Foursquare venue ID
+     * @return object     The venue data
+     */
+    function get_venue( $id ) {
+        // Check for cached data
+        $transient_name = 'foursquare_venue_' . $id;
+        $data = get_transient( $transient_name );
+        // If we don't have data, make an API request
+        if ( $data === false ) {
+            $request_url = 'https://api.foursquare.com/v2/venues/' . $id . '?client_id=' . $this->settings->options['api_key']['client_id'] . '&client_secret=' . $this->settings->options['api_key']['client_secret'] . '&v=20140702';
+            $response = wp_remote_get( $request_url, array( 'sslverify' => false ) );
+            if( is_wp_error( $response ) ) {
+                $data = $response;
+            } else {
+                $data = json_decode( $response['body'] );
+                $data = $data->response->venue;
+                set_transient( $transient_name, $data, 15 * 60 );
+            }
+        }
+        // Give up the data
+        return $data;
+    }
+
+    /**
+     * This callback adds the help tab's content to the settings page
+     */
+    function add_help_tab() {
+        $screen = get_current_screen();
+
+        $venue = $this->get_venue( '3fd66200f964a520d6f01ee3' );
+        if ( is_wp_error( $venue ) ) {
+            $table = '<p><strong>' . __( 'Error:' ) . '</strong> ' . $venue->get_error_message() . '</p>';
+        } else {
+            $table = '<table class="foursquare-venue-replacements"><thead><tr><th>' . __( 'Placeholder' ) . '</th><td>' . __( 'Example Value' ) . '</td></tr></thead><tbody>';
+            $replacements = $this->get_replacements( $venue );
+            foreach ( $replacements as $key => $value ) {
+                $table .= '<tr><th>%%' . $key . '%%</th><td>' . $value . '</td></tr>';
+            }
+            $table .= '</tbody></table>';
+        }
+
+        // Add placeholder help tab
+        $screen->add_help_tab( array(
+            'id'    => 'foursquare_venue_placeholder_help_tab',
+            'title' => __('Venue Placeholders'),
+            'content'   => '<h2>' . __( 'Venue Placeholders' ) . '</h2><p>' . __( 'These placeholders will be replaced with the appropriate data in your display template.' ) . '</p>' . $table,
+        ) );
+        // Add shortcode help tab
+        $screen->add_help_tab( array(
+            'id'    => 'foursquare_venue_shortcode_help_tab',
+            'title' => __('Venue Shortcode'),
+            'content'   => '<h2>' . __( 'Venue Shortcode' ) . '</h2><p>' . __( 'The <code>[venue]</code> shortcode can be used to display venue information and stats from Foursquare.' ) . '</p><p>' . __( 'To use the shortcode you will need the venue\'s Foursquare ID. The ID is found at the end of the venue\'s Foursquare URL. For example, The White House\'s venue URL is <code>https://foursquare.com/v/the-white-house/3fd66200f964a520d6f01ee3</code>, which means the ID is <code>3fd66200f964a520d6f01ee3</code>.' ) . '</p>' . __( 'Once you have the venue ID, you can insert the shortcode with the venue ID included. Example: <code>[venue id="3fd66200f964a520d6f01ee3"]</code>' ) . '</p>'
+        ) );
+
+        $screen->set_help_sidebar( '<p>' . __( 'For support, please visit the <a href="http://wordpress.org/support/plugin/foursquare-venue">WordPress forums</a>.' ) . '</p>' );
+    }
+
 }
 
-function foursquare_venue_deactivate() {
-    delete_option('foursquare_venue_client_id');
-    delete_option('foursquare_venue_client_secret');
-    delete_option('foursquare_venue_show_title');
-    delete_option('foursquare_venue_stats_title');
-    delete_option('foursquare_show_venue_name');
-    delete_option('foursquare_show_venue_icon');
-    delete_option('foursquare_show_here_now');
-    delete_option('foursquare_show_here_now_text');
-    delete_option('foursquare_show_total');
-    delete_option('foursquare_show_total_text');
-    delete_option('foursquare_show_mayor');
-    delete_option('foursquare_show_mayor_text');
-    delete_option('foursquare_link_mayor');
-    delete_option('foursquare_show_mayor_photo');
-    delete_option('foursquare_mayor_photo_size');
-    delete_option('foursquare_venue_stats_width');
-    delete_option('foursquare_venue_stats_align');
-}
-
-function getVenueInfo($id) {
-    // Check for cached data
-    $transient = "foursquare_venue_$id";
-    $data = get_transient( $transient );
-    // Fetch and cache data if needed
-    if( false === $data )
-    {
-        $client_id = get_option('foursquare_venue_client_id');
-        $client_secret = get_option('foursquare_venue_client_secret');
-        $request = "https://api.foursquare.com/v2/venues/$id?client_id=$client_id&client_secret=$client_secret&v=20111113";
-        $response = wp_remote_get( $request, array( 'sslverify' => false ) );
-        if( is_wp_error( $response ) ) {
-            $error_string = $response->get_error_message();
-            echo '<div id="message" class="error"><p>' . $error_string . '</p></div>';
-        } else {
-            $data = json_decode($response['body']);
-            set_transient( $transient, $data, 15 * 60 );
-        }
-    }
-    // Return the data
-    return $data;
-}
-
-function renderVenueInfo($venue) {
-    $venueName = $venue->response->venue->name;
-    $venueIcon = $venue->response->venue->categories[0]->icon;
-    $venueURL = $venue->response->venue->shortUrl;
-    
-    $stats_title = get_option('foursquare_venue_stats_title');
-
-    if(get_option('foursquare_venue_show_title')==1) {
-        $rendered_html .= '<h3>';
-        $rendered_html .= $stats_title;
-        $rendered_html .= '</h3>';
-    }
-    if(get_option('foursquare_show_venue_name')==1) {
-        $rendered_html .= '<h4>';
-        if(get_option('foursquare_show_venue_icon')==1) $rendered_html .= '<img src="' . $venueIcon . '" style="border: 0; margin: 0;" /> ';
-        $rendered_html .= '<a href="' . $venueURL . '">';
-        $rendered_html .= $venueName;
-        $rendered_html .= '</a>';
-        $rendered_html .= '</h4>';
-    }
-    return $rendered_html;
-}
-
-function renderVenueStats($venue) {
-    $mayor = $venue->response->venue->mayor->user->firstName . ' ' . $venue->response->venue->mayor->user->lastName;
-    $mayorURL = 'http://foursquare.com/user/' . $venue->response->venue->mayor->user->id;
-    $mayorPic = $venue->response->venue->mayor->user->photo;
-    $mayorCount = $venue->response->venue->mayor->count;
-    $hereNow = $venue->response->venue->hereNow->count;
-    $totalCheckins = $venue->response->venue->stats->checkinsCount;
-    
-    $here_now_text = get_option('foursquare_show_here_now_text');
-    if($here_now_text=='') $here_now_text = 'People here now:';
-    $total_text = get_option('foursquare_show_total_text');
-    if($total_text=='') $total_text = 'Total check-ins:';
-    $mayor_text = get_option('foursquare_show_mayor_text');
-    if($mayor_text=='') $mayor_text = 'Mayor:';
-
-    $rendered_html .= '<ul>';
-    if(get_option('foursquare_show_here_now')==1) $rendered_html .= '<li>' . $here_now_text . ' ' . $hereNow . '</li>';
-    if(get_option('foursquare_show_total')==1) $rendered_html .= '<li>' . $total_text . ' ' . $totalCheckins . '</li>';
-    if(get_option('foursquare_show_mayor')==1) {
-        $rendered_html .= '<li>' . $mayor_text . ' ';
-        if(get_option('foursquare_link_mayor')==1) $rendered_html .= '<a href="' . $mayorURL . '" title="' . $mayorCount . ' check-ins in the past 2 months" >';
-        $rendered_html .= $mayor;
-        if(get_option('foursquare_link_mayor')==1) $rendered_html .= '</a>';
-        if(get_option('foursquare_show_mayor_photo')==1) $rendered_html .=  ' <img src="' . $mayorPic . '" height="' . get_option('foursquare_mayor_photo_size') . '" width="' . get_option('foursquare_mayor_photo_size') . '" style="border:0;margin:0;" />';
-        $rendered_html .= '</li>';
-    }
-    $rendered_html .= '</ul>';
-    return $rendered_html;
-}
-
-class Foursquare_Venue extends WP_Widget 
-{
-
-    function Foursquare_Venue() 
-    {
-        $widget_ops = array('classname' => 'foursquare_venue_widget', 'description' => 'Foursquare Venue');
-        $this->WP_Widget('foursquare_venue', 'Foursquare Venue', $widget_ops);
-    }
-
-    function widget($args, $instance) 
-    {
-        extract($args);
-        
-        $id=str_replace("https://foursquare.com/venue/", "", $instance['venue_id']);
-        $id=str_replace("http://foursquare.com/venue/", "", $id);
-        $venue = getVenueInfo($id);
-
-        echo $before_widget;
-        $title = strip_tags($instance['title']);
-        echo $before_title . $title . $after_title;
-
-        echo renderVenueStats($venue);
-
-        echo $after_widget;
-    }
-
-    function update($new_instance, $old_instance) 
-    {
-        $instance = $old_instance;
-        $instance['title'] = strip_tags($new_instance['title']);
-        $instance['venue_id'] = trim(strip_tags($new_instance['venue_id']));
-
-        return $instance;
-    }
-
-    function form($instance) 
-    {
-        $instance = wp_parse_args((array)$instance, array('title' => 'Foursquare', 'venue_id' => 3945));
-        $title = strip_tags($instance['title']);
-        $venue_id = strip_tags($instance['venue_id']);
+$foursquare_venue_plugin = new Foursquare_Venue_Plugin();
+
 ?>
-            <p><label for="<?php echo $this->get_field_id('title'); ?>">Title: <input class="widefat" id="<?php echo $this->get_field_id('title'); ?>" name="<?php echo $this->get_field_name('title'); ?>" type="text" value="<?php echo attribute_escape($title); ?>" /></label></p>
-            <p><label for="<?php echo $this->get_field_id('venue_id'); ?>">Venue ID: <input class="widefat" id="<?php echo $this->get_field_id('venue_id'); ?>" name="<?php echo $this->get_field_name('venue_id'); ?>" type="text" value="<?php echo attribute_escape($venue_id); ?>" /></label></p>
-<?php
-    }
-}
-
-add_action('widgets_init', 'RegisterFoursquareVenueWidget');
-
-function RegisterFoursquareVenueWidget() {
-    register_widget('Foursquare_Venue');
-}
-
-// Shortcode
-
-function show_foursquare_venue($atts) {
-    extract(shortcode_atts(array(
-        'id' => '',
-    ), $atts));
-    
-$id=str_replace("https://foursquare.com/venue/", "", $id);
-$id=str_replace("http://foursquare.com/venue/", "", $id);
-
-        $venue = getVenueInfo($id);
-        
-        if ($venue->meta->code==200) {
-
-        $widget_html = '<div class="venue-stats';
-        if(get_option('foursquare_venue_stats_align')=='left') $widget_html .= ' alignleft';
-        if(get_option('foursquare_venue_stats_align')=='right') $widget_html .= ' alignright';
-        $widget_html .= '"';
-        if(get_option('foursquare_venue_stats_width')!='') $widget_html .= ' style="width:' . get_option('foursquare_venue_stats_width') . ';"';
-        $widget_html .= '>';
-
-        // Display Venue's Info
-        $widget_html .= renderVenueInfo($venue);
-
-        // Display Venue's Statistics
-        $widget_html .= renderVenueStats($venue);
-
-        $widget_html .= '</div>';
-        
-        return $widget_html;
-        
-        } else {
-            return '[<strong>Error: '.$venue->meta->errorDetail.'</strong>]';
-        }
-}
-
-add_shortcode('venue', 'show_foursquare_venue');
-
-// Admin Page
-
-add_action('admin_menu', 'foursquare_venue_menu');
-
-function foursquare_venue_menu() {
-
-  add_options_page('Foursquare Venue Options', 'Foursquare Venue', 'manage_options', 'foursquare-venue-options', 'foursquare_venue_options');
-
-}
-
-function foursquare_venue_options() {
-
-  if (!current_user_can('manage_options'))  {
-    wp_die( __('You do not have sufficient permissions to access this page.') );
-  }
-
-?>
-
-<div class="wrap">
-
-    <div id="icon-plugins" class="icon32"></div><h2>Foursquare Venue</h2>
-    
-    <h3>Getting Started</h3>
-    
-    <p>Before using this plugin, you'll have to set up a free Foursquare API key. Visit <a href="https://foursquare.com/oauth/">foursquare.com/oauth</a>, click "Register a new consumer," then enter the name of your site, your site's address, and for "Callback URL" just enter your site's address again. You'll be given two keys, "Client ID" and "Client Secret," which need to be copied and pasted into the matching fields on this page.</p>
-    <p>After saving your API key you'll be able to start using the widget or shortcode. To use the widget simply add it to your sidebar and set the venue's ID. To use the shortcode just insert <code>[venue id=23647]</code> (replacing the '23647' with the desired venue's ID) into any post or page, and the plugin do the rest.</p>
-    <p>The venue's ID can be found by taking the number from the end of the venue's page on the Foursquare website. For example, if the venue's URL is <code>https://foursquare.com/venue/<span style="color:green;">1278862</span></code>, the id is <code>1278862</code>.</p>
-    
-    <div id="icon-options-general" class="icon32"></div><h2>Options</h2>
-
-    <form method="post" action="options.php">
-    <?php wp_nonce_field('update-options'); ?>
-
-    <h3>API Key</h3>
-    
-    <table class="form-table">
-    
-    <tr valign="top">
-    <th scope="row">Client ID</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Client ID</span></legend> 
-    <input name="foursquare_venue_client_id" type="text" id="foursquare_venue_client_id" value="<?php echo get_option('foursquare_venue_client_id'); ?>" />
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Client Secret</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Client Secret</span></legend> 
-    <input name="foursquare_venue_client_secret" type="text" id="foursquare_venue_client_secret" value="<?php echo get_option('foursquare_venue_client_secret'); ?>" />
-    </fieldset></td> 
-    </tr>
-    
-    </table>
-
-    <h3>Check-ins</h3>
-    
-    <table class="form-table">
-    
-    <tr valign="top"> 
-    <th scope="row">Show Current Check-ins</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Show the number of people currently checked-in</span></legend> 
-    <label for="foursquare_show_here_now"><input name="foursquare_show_here_now" type="checkbox" id="foursquare_show_here_now" value="1" <?php if(get_option('foursquare_show_here_now')==1) echo "checked='checked'"; ?>/> Show the number of people currently checked-in</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Current Check-ins Text</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Customize the text for the current number of check-ins</span></legend> 
-    <label for="foursquare_show_here_now_text"><input name="foursquare_show_here_now_text" type="text" id="foursquare_show_here_now_text" value="<?php if(($here_now_text=get_option('foursquare_show_here_now_text'))!='') echo $here_now_text; else echo 'People here now:'; ?>" /> Customize the text for the current number of check-ins</label> 
-    </fieldset></td> 
-    </tr>
-
-    <tr valign="top"> 
-    <th scope="row">Show Total Check-ins</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Show the total number of check-ins</span></legend> 
-    <label for="foursquare_show_total"><input name="foursquare_show_total" type="checkbox" id="foursquare_show_total" value="1" <?php if(get_option('foursquare_show_total')==1) echo "checked='checked'"; ?>/> Show the total number of check-ins</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Total Check-ins Text</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Customize the text for the total number of check-ins</span></legend> 
-    <label for="foursquare_show_total_text"><input name="foursquare_show_total_text" type="text" id="foursquare_show_total_text" value="<?php if(($total_text=get_option('foursquare_show_total_text'))!='') echo $total_text; else echo 'Total check-ins:'; ?>" /> Customize the text for the total number of check-ins</label> 
-    </fieldset></td> 
-    </tr>
-    
-    </table>
-    
-    <h3>Mayor</h3>
-    
-    <table class="form-table">
-    
-    <tr valign="top"> 
-    <th scope="row">Show Mayor</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Show the current mayor</span></legend> 
-    <label for="foursquare_show_mayor"><input name="foursquare_show_mayor" type="checkbox" id="foursquare_show_mayor" value="1" <?php if(get_option('foursquare_show_mayor')==1) echo "checked='checked'"; ?>/> Show the current mayor</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Mayor Text</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Customize the text for the mayor</span></legend> 
-    <label for="foursquare_show_mayor_text"><input name="foursquare_show_mayor_text" type="text" id="foursquare_show_mayor_text" value="<?php if(($mayor_text=get_option('foursquare_show_mayor_text'))!='') echo $mayor_text; else echo 'Mayor:'; ?>" /> Customize the text for the mayor</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top"> 
-    <th scope="row">Link to Mayor</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Link to the current mayor</span></legend> 
-    <label for="foursquare_link_mayor"><input name="foursquare_link_mayor" type="checkbox" id="foursquare_link_mayor" value="1" <?php if(get_option('foursquare_link_mayor')==1) echo "checked='checked'"; ?>/> Link to the current mayor</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Show Mayor's Photo</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Show a photo of the current mayor next to their name</span></legend> 
-    <label for="foursquare_show_mayor_photo"><input name="foursquare_show_mayor_photo" type="checkbox" id="foursquare_show_mayor_photo" value="1" <?php if(get_option('foursquare_show_mayor_photo')==1) echo "checked='checked'"; ?>/> Show a photo of the current mayor next to their name</label> 
-    </fieldset></td> 
-    </tr>
-
-    <tr valign="top">
-    <th scope="row">Mayor Photo Size</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Choose what size to display the mayor's photo</span></legend> 
-    <label for="foursquare_mayor_photo_size"><input name="foursquare_mayor_photo_size" type="text" id="foursquare_mayor_photo_size" value="<?php echo get_option('foursquare_mayor_photo_size'); ?>" size="3" />px (ex: 32 will create a 32x32 photo)</label> 
-    </fieldset></td> 
-    </tr>
-    
-    </table>
-    
-    <h3>Style</h3>
-    
-    <p>Note: These settings do not affect the Foursquare Venue widget, only the shortcode. Advanced users can style their Foursquare stats using CSS. Ex: <code>.venue-stats { width: 300px; float: right; }</code></p>
-    
-    <table class="form-table">
-    
-    <tr valign="top"> 
-    <th scope="row">Show Shortcode Title</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Show the current mayor</span></legend> 
-    <label for="foursquare_venue_show_title"><input name="foursquare_venue_show_title" type="checkbox" id="foursquare_venue_show_title" value="1" <?php if(get_option('foursquare_venue_show_title')==1) echo "checked='checked'"; ?>/> Show a title above the Foursquare stats</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Shortcode Title Text</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Customize the text for the mayor</span></legend> 
-    <label for="foursquare_venue_stats_title"><input name="foursquare_venue_stats_title" type="text" id="foursquare_venue_stats_title" value="<?php if(($mayor_text=get_option('foursquare_venue_stats_title'))!='') echo $mayor_text; else echo 'Mayor:'; ?>" /> Customize the title above the stats</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top"> 
-    <th scope="row">Show Venue Name</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Show the venue name</span></legend> 
-    <label for="foursquare_show_venue_name"><input name="foursquare_show_venue_name" type="checkbox" id="foursquare_show_venue_name" value="1" <?php if(get_option('foursquare_show_venue_name')==1) echo "checked='checked'"; ?>/> Show name and link to the venue</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top"> 
-    <th scope="row">Show Venue Icon</th> 
-    <td><fieldset><legend class="screen-reader-text"><span>Show venue icon</span></legend> 
-    <label for="foursquare_show_venue_icon"><input name="foursquare_show_venue_icon" type="checkbox" id="foursquare_show_venue_icon" value="1" <?php if(get_option('foursquare_show_venue_icon')==1) echo "checked='checked'"; ?>/> Show an icon for the venue's category</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Width</th> 
-    <td><fieldset>
-    <label for="foursquare_venue_stats_width"><input name="foursquare_venue_stats_width" type="text" id="foursquare_venue_stats_width" value="<?php echo get_option('foursquare_venue_stats_width'); ?>" size="3" />px</label> 
-    </fieldset></td> 
-    </tr>
-    
-    <tr valign="top">
-    <th scope="row">Align</th> 
-    <td><fieldset>
-    <label for="foursquare_venue_stats_alignleft"><input type="radio" name="foursquare_venue_stats_align" id="foursquare_venue_stats_alignleft" value="left" <?php if(get_option('foursquare_venue_stats_align')=='left') echo 'checked="checked" '; ?>/> Left</label> <label for="foursquare_venue_stats_alignright"><input type="radio" name="foursquare_venue_stats_align" id="foursquare_venue_stats_alignright" value="right" <?php if(get_option('foursquare_venue_stats_align')=='right') echo 'checked="checked" '; ?>/> Right</label> <label for="foursquare_venue_stats_alignnone"><input type="radio" name="foursquare_venue_stats_align" id="foursquare_venue_stats_alignnone" value="" <?php if(get_option('foursquare_venue_stats_align')=='') echo 'checked="checked" '; ?>/> None</label> 
-    </fieldset></td> 
-    </tr>
-    
-    </table>
-    
-    <input type="hidden" name="action" value="update" />
-    <input type="hidden" name="page_options" value="foursquare_venue_client_id,foursquare_venue_client_secret,foursquare_venue_show_title,foursquare_venue_stats_title,foursquare_show_venue_name,foursquare_show_venue_icon,foursquare_show_here_now,foursquare_show_here_now_text,foursquare_show_total,foursquare_show_total_text,foursquare_show_mayor,foursquare_show_mayor_text,foursquare_link_mayor,foursquare_show_mayor_photo,foursquare_mayor_photo_size,foursquare_venue_stats_width,foursquare_venue_stats_align" />
-    
-    <p class="submit">
-    <input type="submit" class="button-primary" value="<?php _e('Save Changes') ?>" />
-    </p>
-    
-    </form>
-
-</div>
-
-<?php
-
-}
-
-?>

foursquare-venue/trunk/readme.txt

@@ -3 +3 @@
 Donate link: http://wie.ly/u/donate
 Tags: foursquare, venue, widget, social networking, location
-Requires at least: 3.0
-Tested up to: 3.8.1
-Stable tag: 2.2.2
+Requires at least: 3.5
+Tested up to: 3.9.1
+Stable tag: 3.0
 
 Foursquare Venue is a simple but powerful plugin for displaying any venue's Foursquare stats.
@@ -11 +11 @@
 == Description ==
 
-Foursquare Venue gives you the ability to display any venue's latest stats on your WordPress site. Using either the widget or shortcode, you will be able to display:
+Foursquare Venue gives you the ability to display any venue's latest stats on your WordPress site. Using either the widget or shortcode, you will be able to display everything from a venue's address, to average rating, to mayor, and more!
 
-*   People here now
-*   Total check-ins
-*   Current mayor (along with their picture and number of check-ins)
+**New!** Foursquare Venue 3.0 has been entirely rewritten to support the latest Foursquare API and give users more control over how data is displayed. Note: If you are already running Foursquare Venue, you will need to reconfigure the plugin.
 
-I'm open to any feedback and suggestions.
+= Our Other Plugins =
+
+[Video Thumbnails](https://refactored.co/plugins/video-thumbnails) | [Video Importer](https://refactored.co/plugins/video-importer) | [Retinamatic](http://retinamatic.com/)
 
 == Installation ==
@@ -27 +27 @@
 
 * On the 'Widgets' page listed under 'Appearance,' drag the Foursquare Venue widget to your desired widget area and set the venue ID.
-* On any post or page, add the shortcode `[venue id=3945]`, replacing the '3945' with the venue's ID.
+* On any post or page, add the shortcode `[venue id=abc123]`, replacing the 'abc123' with the venue's ID.
 
-The venue's ID can be found as a number at the end of the venue's URL on Foursquare.
+The venue's ID can be found as a string of random numbers and letters at the end of the venue's URL on Foursquare.
 
 == Frequently Asked Questions ==
@@ -35 +35 @@
 = The stats are wrong or I'm getting an error, what did I do wrong? =
 
-The most likely problem is that you haven't set a proper venue ID. This is the number from the end of the venue's URL (ex: `3945`).
+The most likely problem is that you haven't set a proper venue ID. This is the number from the end of the venue's URL (ex: `3fd66200f964a520d6f01ee3`).
 
 == Screenshots ==
 
-1. The full set of options
-2. Shortcode in use with custom settings applied
+1. The shortcode in action
+2. Settings page
+3. Help tab on settings page
 
 == Changelog ==
+
+= 3.0 =
+* Rewritten from the ground up to give users more control
+* Uses the latest Foursquare API
+* If you are already using the plugin, you will need to reconfigure the settings.
 
 = 2.2.2 =