lentil 0.0.1.pre

data/vendor/assets/javascripts/infinitescroll/wordpress-plugin/readme.md

@@ -0,0 +1,246 @@
+# Infinite-Scroll #
+**Contributors:** beaver6813, dirkhaim, paul.irish, benbalter  
+**Donate link:** http://www.infinite-scroll.com  
+**Tags:** ajax, pagination, scrolling, scroll, endless, reading  
+**Requires at least:** 3.2  
+**Tested up to:** 3.4  
+**Stable tag:** 2.0b  
+
+Automatically append the next page of posts (via AJAX) to your page when a user scrolls to the bottom. 
+
+## Description ##
+
+Infinite scroll has been called autopagerize, unpaginate, endless pages. But essentially it is pre-fetching content from a subsequent page and adding it directly to the user’s current page.
+
+When a user scrolls towards the bottom of the page, the next page of posts is automatically retrieved and appended. This means they never need to click "Next Page", which *dramatically increases stickiness*.  
+
+Features:
+
+* Works out-of-the-box for many popular WordPress themes -- just activate the plugin and scroll
+* Fully customizable to adapt to your site and theme
+* Requires no (hopefully) template hacking, only a knowledge of CSS selectors.
+* Relies on shared database of common themes to simplify installation process
+* Maintain local database of theme presets for all installed themes (shared across network on multisite installs)
+* Countless API endpoints to modify the behavior.
+* Backwards compatible: Will not break RSS readers, mobile devices, or browsers with javascript  
+
+Full information on [infinite-scroll.com](http://www.infinite-scroll.com)
+
+## Screenshots ##
+
+### 1. CSS Selector (theme) configuration options ###
+![CSS Selector (theme) configuration options](https://github.com/benbalter/Infinite-Scroll/raw/develop/screenshot-1.png)
+
+### 2. Text and image options (to display as additional posts load) ###
+![Text and image options (to display as additional posts load)](https://github.com/benbalter/Infinite-Scroll/raw/develop/screenshot-2.png)
+
+### 3. Edit theme presets screen ###
+![Edit theme presets screen](https://github.com/benbalter/Infinite-Scroll/raw/develop/screenshot-3.png)
+
+## Changelog ##
+
+### 2.5 ###
+* Plugin completely rewritten from the bottom up
+* **Note: you will need to manually reactivate this plugin after upgrading**  
+* Minimum WordPress version required now to **3.2**
+* Added support for internationalization (see FAQ for information on translating)
+* Added support for custom post types (now works on all pages but `is_singular()`)
+* Options screens significantly simplified with additional help text
+* Presets screen now uses standard WordPress administrative interface
+* Ability to submit your theme's CSS Selectors to the community CSS selector database to aid others with installation
+* Changes to presets are now made inline; saved via AJAX without page reload
+* Added additional API endpoints for developers to modify and customize plugin behavior
+* Loading image now uses native WordPress uploader and can accept arbitrary URL or image from media gallery
+* Loading and finished text now uses native WordPress TinyMCE editor
+* If site administrator has not entered CSS selectors and preset is known, plugin will default to preset
+* Any preset entered by site (or network) administrator will now override community contributed presets by default
+* Community contributed CSS selector presets are now stored in the database allowing for plugin directory to be unwritable (security enhancement)
+* Prompts users to default to CSS selector preset when available
+* Presets now support child themes
+* Community contributed CSS selected asynchronously update daily (performance enhancement)
+* Site (or network) specific CSS selector presets are now stored in the database (security enhancement)
+* CSS Preset updater now uses WP_HTTP class (compatibility enhancement)
+* Javascript file now served directly to user (rather than proxied via PHP) to allow for browser caching, minification, serving via CDN, and better integration with caching plugins (performance enhancement)
+* Javascript options stored natively in database and passed directly to script via WordPress's `wp_localize_script` function (performance and customizability enhancement)
+* No longer relies on deprecated user levels to determine permissions
+* Default loading and fished messages changed
+* Fixes for error and warnings when run with `WP_DEBUG` enabled
+* Removed prompt for option to activate infinite scrolling for only certain users (defaults to all)
+* Removed prompt for option to toggle debug mode (defaults to `WP_DEBUG` or `SCRIPT_DEBUG`)
+* Removed prompt for option to toggle scrolling behavior (defaults to automatic)
+* Removed prompt for additional callbacks
+* Removed prompt to select image alignment (defaults to left, can override via CSS)
+* Significant code clean up, file reorganization, and in-line documentation to conform to WordPress coding and style standards (whitespace, double v. single quotes, tab drift, trailing commas, closing PHP tags, etc.)
+* Classes loaded as sub-classes (rather than extending parent class) to prevent classes from becoming out of sync
+* Added phpdoc style documentation
+* Plugin file name changed to conform to standard WordPress naming conventions
+* License (GPL) included with distribution
+* Version numbering simplified
+
+### 2.0b2.120111 ###
+* Added infinite_scroll_load_override filter to manually force infinite-scroll to load on a page.
+* Thanks to https://github.com/samargulies for the above patch.
+
+### 2.0b2.111218 ###
+* Updated preset DB with basic themes
+* Made a few fixes in options/presets to prep for main release.
+* Changed hook used by 404 detection to template_redirect from wp.
+
+### 2.0b2.110822 ###
+* Removed registration/enqueuing script in favor of just enqueueing
+* Fixed bug/typo in compressed init script
+
+### 2.0b2.110821 ###
+* Converted options pages to use Settings API
+* Added behavior selection (Manual triggering)
+
+### 2.0b2.110818 ###
+* Completely revamped admin panel adding more modular management
+* Added ability to center loading image
+* Added WYSIWYG editor to HTML allowed fields in admin panel
+* Updated Javascript callback to pass DOM for new elements added
+* Added Preset manager
+* Added ability to auto-fill selector fields from theme preset
+* Overhaul of underlying code, separating out into classes to cut down
+on code processed (and hence load time) for the end-user.
+
+### 2.0b2.110723 ###
+* Improved escaping on settings to allow greater flexibility.
+* Fixed issue with jQuery not loading if WP version is up to date.
+* Fixed issue with plugin showing twice on plugin list.
+
+### 2.0b2.110716 ###
+* Moved init script from direct page insertion to separate script.
+* Cleaned up unneeded declared constants.
+* Combined init script and library into one minified script.
+* This fixes an incompatibility with HeadJS plugin.
+
+### 2.0b2.110713 ###
+* Fixed multiple jQuery loaded conflicts.
+* Now uses standard WordPress javascript insertion.
+* Loads locally stored jQuery 1.6.2 if current version is < 1.6
+  this can only be detected through WordPress now, hence the fix
+  for multiple versions conflicting (some naughty themes don't
+  use WordPress's javascript loading).
+
+### 2.0b2.110709 ###
+* FIX: Default options not being recursively copied.  
+* Updated to new options layout.
+* Callback fix.
+
+### 2.0b2.110706 ###
+* HTTPS loading image fix.
+* Better debug support (switches between minified and non).
+
+### 2.0b2.110629 ###
+* Callback (custom javascript) fix.
+* IE9 binding bug fix.
+
+### 2.0b2.110628 ###
+* Modified the method used to determine the link paths (bug fix)
+
+### 2.0b2.110617 ###
+* Updated core javascript to version 2.0b2.110617 (full revamp).
+* General cleanup/tidy of plugin itself.
+* Fixed bugs with numerical sub-domains (now uses site_url to determine path).
+* Supports archives, tags, searches.
+* Wider theme support.
+* Simplified plugin options page, added loading image upload ability, added option for debug mode.
+* Removed annoying reminder that showed on all admin pages.
+* Forces 404 header when no more posts are available.
+
+### 1.5.100504 ###
+* New appending technique using document fragments.
+* Callback receives the contentSelector elem as its first argument,
+    and an array of the new elements as the second argument
+
+### 1.4.100210 ###
+Fixed small bug that jQuery 1.4 introduced.
+
+### 1.4 ###
+Proper WordPress method (enqueue_script) removed because it just breaks too often
+JS updated with some custom method action.
+
+### 1.3 ###
+Use proper WordPress function to register the javascript
+Use plugins_url to determine plugin url
+
+### 1.2 ###
+* 2009 August 4th
+* `get_option('siteurl')` fix made.
+* jQuery plugin version updated. many more options available.
+* Release backwards compatible
+
+### 1.1 ###
+* 2008 September 25
+* JavaScript rewritten as a proper jQuery plugin.
+* Added animation
+
+### 1.0 ###
+* June 29 - 1.0 release.
+
+## Frequently Asked Questions ##
+
+### What exactly is infinite scrolling? ###
+
+Essentially it is pre-fetching content from a subsequent page and adding it directly to the user’s current page. [More Information](http://www.infinite-scroll.com/the-interaction-design-pattern/)
+
+### Can I change the number of posts loaded? ###
+
+Yes. Go to Settings -> Reading in your WordPress administrative dashboard.
+
+### How do I change the alignment of the loading image? ###
+
+Add the following to your theme's css: `#infscr-loading img { text-align: ALIGNMENT; }` where "ALIGNMENT" is either `left`, `right`, or `center`.    
+
+### How can I pass additional arguments such as behavior or callbacks to the script? ###
+
+Add a filter to `infinite_scroll_options` and adds additional options to the options array.
+
+### Is the plugin available in my language? ###
+
+If you enjoy the plugin and are interested in contributing a translation (it's super easy), please take a look at the [Translating WordPress](http://codex.wordpress.org/Translating_WordPress) page. 
+
+### Is it SEO-Friendly? ###
+Yes all enhancements are made via javascript only, so search spiders see no difference.
+
+### Is it accessible? ###
+
+Things won’t change for screen-readers. This technique degrades gracefully.
+
+### Does it still keep going, even at the end of the blog? ###
+
+Infinite scroll is configured to die when it hits a 404 Not Found status code, so when it goes through all your archives it should hit a /page/43/ (or something) that doesn’t exist, then show a message "Congrats, you’ve reached the end of the internet." Some WordPress themes don’t report not found pages with a 404. Try a different theme or contacting the theme author.
+
+### Do I need to edit my theme to make this work? ###
+
+Probably not, nope.
+
+### How do I pass additional arguments such as callbacks to the Infinite Scroll script? ###
+
+To pass additional arguments to the Infinite Scroll script, add the following code to either your theme's `functions.php` or to a stand-alone plugin file. 
+
+```
+function my_infinite_scroll_options_filter( $options ) {
+     $options['callback'] = 'my_callback';
+     $options['another_parameter'] = 'another_value';
+     return $options;
+}
+
+add_filter( 'infinite_scroll_js_options', 'my_infinite_scroll_options_filter' );
+```
+
+## Installation ##
+
+### Automatic Install ###
+1. Login to your WordPress site as an Administrator
+2. Navigate to Plugins->Add New from the menu on the left
+3. Search for "Infinite Scroll"
+4. Click "Install"
+5. Click "Activate Now"
+
+### Manual Install ###
+1. Download the plugin from the link in the top left corner
+2. Unzip the file, and upload the resulting "infinite-scroll" folder to your "/wp-content/plugins directory" as "/wp-content/plugins/infinite-scroll"
+3. Log into your WordPress install as an administrator, and navigate to the plugins screen from the left-hand menu
+4. Activate Infinite Scroll

data/vendor/assets/javascripts/infinitescroll/wordpress-plugin/readme.txt

@@ -0,0 +1,241 @@
+=== Infinite-Scroll ===
+Contributors: beaver6813, dirkhaim, paul.irish, benbalter
+Donate link: http://www.infinite-scroll.com
+Tags: ajax, pagination, scrolling, scroll, endless, reading
+Requires at least: 3.2
+Tested up to: 3.4
+Stable tag: 2.0b
+
+Automatically append the next page of posts (via AJAX) to your page when a user scrolls to the bottom. 
+
+== Description ==
+
+Infinite scroll has been called autopagerize, unpaginate, endless pages. But essentially it is pre-fetching content from a subsequent page and adding it directly to the user’s current page.
+
+When a user scrolls towards the bottom of the page, the next page of posts is automatically retrieved and appended. This means they never need to click "Next Page", which *dramatically increases stickiness*.  
+
+Features:
+
+* Works out-of-the-box for many popular WordPress themes -- just activate the plugin and scroll
+* Fully customizable to adapt to your site and theme
+* Requires no (hopefully) template hacking, only a knowledge of CSS selectors.
+* Relies on shared database of common themes to simplify installation process
+* Maintain local database of theme presets for all installed themes (shared across network on multisite installs)
+* Countless API endpoints to modify the behavior.
+* Backwards compatible: Will not break RSS readers, mobile devices, or browsers with javascript
+
+Full information on [infinite-scroll.com](http://www.infinite-scroll.com)
+
+== Changelog ==
+
+= 2.5 =
+* Plugin completely rewritten from the bottom up
+* **Note: you will need to manually reactivate this plugin after upgrading**
+* Minimum WordPress version required now to **3.2**
+* Added support for internationalization (see FAQ for information on translating)
+* Added support for custom post types (now works on all pages but `is_singular()`)
+* Options screens significantly simplified with additional help text
+* Presets screen now uses standard WordPress administrative interface
+* Ability to submit your theme's CSS Selectors to the community CSS selector database to aid others with installation
+* Changes to presets are now made inline; saved via AJAX without page reload
+* Added additional API endpoints for developers to modify and customize plugin behavior
+* Loading image now uses native WordPress uploader and can accept arbitrary URL or image from media gallery
+* Loading and finished text now uses native WordPress TinyMCE editor
+* If site administrator has not entered CSS selectors and preset is known, plugin will default to preset
+* Any preset entered by site (or network) administrator will now override community contributed presets by default
+* Community contributed CSS selector presets are now stored in the database allowing for plugin directory to be unwritable (security enhancement)
+* Prompts users to default to CSS selector preset when available
+* Presets now support child themes
+* Community contributed CSS selectors now stored as standard CSV and asynchronously update daily (performance and compatibility enhancement)
+* Site (or network) specific CSS selector presets are now stored in the database (security enhancement)
+* CSS Preset updater now uses WP_HTTP class (compatibility enhancement)
+* Javascript file now served directly to user (rather than proxied via PHP) to allow for browser caching, minification, serving via CDN, and better integration with caching plugins (performance enhancement)
+* Javascript options stored natively in database and passed directly to script via WordPress's `wp_localize_script` function (performance and customizability enhancement)
+* No longer relies on deprecated user levels to determine permissions
+* Default loading and fished messages changed
+* Fixes for error and warnings when run with `WP_DEBUG` enabled
+* Removed prompt for option to activate infinite scrolling for only certain users (defaults to all)
+* Removed prompt for option to toggle debug mode (defaults to `WP_DEBUG` or `SCRIPT_DEBUG`)
+* Removed prompt for option to toggle scrolling behavior (defaults to automatic)
+* Removed prompt for additional callbacks
+* Removed prompt to select image alignment (defaults to left, can override via CSS)
+* Significant code clean up, file reorganization, and in-line documentation to conform to WordPress coding and style standards (whitespace, double v. single quotes, tab drift, trailing commas, closing PHP tags, etc.)
+* Classes loaded as sub-classes (rather than extending parent class) to prevent classes from becoming out of sync
+* Added phpdoc style documentation
+* Plugin file name changed to conform to standard WordPress naming conventions
+* License (GPL) included with distribution
+* Version numbering simplified
+
+= 2.0b2.120111 =
+* Added infinite_scroll_load_override filter to manually force infinite-scroll to load on a page.
+* Thanks to https://github.com/samargulies for the above patch.
+
+= 2.0b2.111218 =
+* Updated preset DB with basic themes
+* Made a few fixes in options/presets to prep for main release.
+* Changed hook used by 404 detection to template_redirect from wp.
+
+= 2.0b2.110822 =
+* Removed registration/enqueuing script in favor of just enqueueing
+* Fixed bug/typo in compressed init script
+
+= 2.0b2.110821 =
+* Converted options pages to use Settings API
+* Added behavior selection (Manual triggering)
+
+= 2.0b2.110818 =
+* Completely revamped admin panel adding more modular management
+* Added ability to center loading image
+* Added WYSIWYG editor to HTML allowed fields in admin panel
+* Updated Javascript callback to pass DOM for new elements added
+* Added Preset manager
+* Added ability to auto-fill selector fields from theme preset
+* Overhaul of underlying code, separating out into classes to cut down
+on code processed (and hence load time) for the end-user.
+
+= 2.0b2.110723 =
+* Improved escaping on settings to allow greater flexibility.
+* Fixed issue with jQuery not loading if WP version is up to date.
+* Fixed issue with plugin showing twice on plugin list.
+
+= 2.0b2.110716 =
+* Moved init script from direct page insertion to separate script.
+* Cleaned up unneeded declared constants.
+* Combined init script and library into one minified script.
+* This fixes an incompatibility with HeadJS plugin.
+
+= 2.0b2.110713 = 
+* Fixed multiple jQuery loaded conflicts.
+* Now uses standard WordPress javascript insertion.
+* Loads locally stored jQuery 1.6.2 if current version is < 1.6
+  this can only be detected through WordPress now, hence the fix
+  for multiple versions conflicting (some naughty themes don't
+  use WordPress's javascript loading).
+
+= 2.0b2.110709 = 
+* FIX: Default options not being recursively copied.
+* Updated to new options layout.
+* Callback fix.
+
+= 2.0b2.110706 = 
+* HTTPS loading image fix.
+* Better debug support (switches between minified and non).
+
+= 2.0b2.110629 = 
+* Callback (custom javascript) fix.
+* IE9 binding bug fix.
+
+= 2.0b2.110628 = 
+* Modified the method used to determine the link paths (bug fix)
+
+= 2.0b2.110617 = 
+* Updated core javascript to version 2.0b2.110617 (full revamp).
+* General cleanup/tidy of plugin itself.
+* Fixed bugs with numerical sub-domains (now uses site_url to determine path).
+* Supports archives, tags, searches.
+* Wider theme support.
+* Simplified plugin options page, added loading image upload ability, added option for debug mode.
+* Removed annoying reminder that showed on all admin pages.
+* Forces 404 header when no more posts are available.
+
+= 1.5.100504 =
+* New appending technique using document fragments.
+* Callback receives the contentSelector elem as its first argument,
+    and an array of the new elements as the second argument
+
+= 1.4.100210 =
+Fixed small bug that jQuery 1.4 introduced.
+
+= 1.4 =
+Proper WordPress method (enqueue_script) removed because it just breaks too often
+JS updated with some custom method action.
+
+= 1.3 =
+Use proper WordPress function to register the javascript
+Use plugins_url to determine plugin url
+
+= 1.2 = 
+* 2009 August 4th
+* `get_option('siteurl')` fix made.
+* jQuery plugin version updated. many more options available.
+* Release backwards compatible
+
+= 1.1 =
+* 2008 September 25
+* JavaScript rewritten as a proper jQuery plugin.
+* Added animation
+
+= 1.0 =
+* June 29 - 1.0 release.
+
+== Screenshots ==
+
+1. CSS Selector (theme) configuration options
+2. Text and image options (to display as additional posts load)
+3. Edit theme presets screen
+
+== Frequently Asked Questions ==
+
+= What exactly is infinite scrolling? =
+
+Essentially it is pre-fetching content from a subsequent page and adding it directly to the user’s current page. [More Information](http://www.infinite-scroll.com/the-interaction-design-pattern/)
+
+= Can I change the number of posts loaded? =
+
+Yes. Go to Settings -> Reading in your WordPress administrative dashboard.
+
+= How do I change the alignment of the loading image? =
+
+Add the following to your theme's css: `#infscr-loading img { text-align: ALIGNMENT; }` where "ALIGNMENT" is either `left`, `right`, or `center`.  
+
+= How can I pass additional arguments such as behavior or callbacks to the script? =
+
+Add a filter to `infinite_scroll_options` and adds additional options to the options array.
+
+= Is the plugin available in my language? =
+
+If you enjoy the plugin and are interested in contributing a translation (it's super easy), please take a look at the [Translating WordPress](http://codex.wordpress.org/Translating_WordPress) page. 
+
+= Is it SEO-Friendly? =
+Yes all enhancements are made via javascript only, so search spiders see no difference.
+
+= Is it accessible? =
+
+Things won’t change for screen-readers. This technique degrades gracefully.
+
+= Does it still keep going, even at the end of the blog? =
+
+Infinite scroll is configured to die when it hits a 404 Not Found status code, so when it goes through all your archives it should hit a /page/43/ (or something) that doesn’t exist, then show a message "Congrats, you’ve reached the end of the internet." Some WordPress themes don’t report not found pages with a 404. Try a different theme or contacting the theme author.
+
+= Do I need to edit my theme to make this work? =
+
+Probably not, nope.
+
+= How do I pass additional arguments such as callbacks to the Infinite Scroll script? =
+
+To pass additional arguments to the Infinite Scroll script, add the following code to either your theme's `functions.php` or to a stand-alone plugin file. 
+
+```
+function my_infinite_scroll_options_filter( $options ) {
+     $options['callback'] = 'my_callback';
+     $options['another_parameter'] = 'another_value';
+     return $options;
+}
+
+add_filter( 'infinite_scroll_js_options', 'my_infinite_scroll_options_filter' );
+```
+
+== Installation ==
+
+= Automatic Install =
+1. Login to your WordPress site as an Administrator
+2. Navigate to Plugins->Add New from the menu on the left
+3. Search for "Infinite Scroll"
+4. Click "Install"
+5. Click "Activate Now"
+
+= Manual Install =
+1. Download the plugin from the link in the top left corner
+2. Unzip the file, and upload the resulting "infinite-scroll" folder to your "/wp-content/plugins directory" as "/wp-content/plugins/infinite-scroll"
+3. Log into your WordPress install as an administrator, and navigate to the plugins screen from the left-hand menu
+4. Activate Infinite Scroll