| 9 | /** |
| 10 | * plugin_get_contents() - Pull in the plugin file contents to get the retrieve just the Plugin Data |
| 11 | * |
| 12 | * Uses file_get_contents() if available, else implements file_get_contents() |
| 13 | * for plugins. |
| 14 | * |
| 15 | * There is a filter hook for getting the amount of bytes to retrieve. In the |
| 16 | * event that the plugins aren't working, please create a plugin which sets |
| 17 | * the hook contents to a higher range until all of the plugins' information |
| 18 | * come up, then report back to the link below, so that the change can be made |
| 19 | * for everyone else. Make sure to reopen. |
| 20 | * |
| 21 | * @link http://trac.wordpress.org/ticket/5651 Ticket for this functions being. |
| 22 | * |
| 23 | * @since 2.5.0 |
| 24 | * @uses apply_filters() Calls 'plugin_get_contents' hook to get the bytes |
| 25 | * to retrieve from the file. |
| 26 | * |
| 27 | * @param string $plugin_file Path to plugin file |
| 28 | * @return string File contents retrieved |
| 29 | */ |
| 30 | function plugin_get_contents($plugin_file) { |
| 31 | $bytes = apply_filters('plugin_get_contents', 1024); |
| 32 | if( function_exists( 'file_get_contents' ) ) |
| 33 | return file_get_contents($plugin_file, null, null, 0, $bytes); |
| 34 | |
| 35 | $fp = fopen($plugin_file); |
| 36 | $contents = fread( $fp, $bytes ); |
| 37 | fclose($fp); |
| 38 | return $contents; |
| 39 | } |
| 40 | |
| 41 | /** |
| 42 | * get_plugin_data() - Parse the plugin contents to retrieve the plugin's data |
| 43 | * |
| 44 | * While this function has only existed since WordPress 2.5, the functionality has |
| 45 | * existed in WordPress for longer. |
| 46 | * |
| 47 | * Plugin data contains the following: |
| 48 | * 'Name' - Name of the plugin, should be unique. |
| 49 | * 'Title' - Title of the plugin and the link to the plugin's web site. |
| 50 | * 'Description' - Description of what the plugin does and/or notes from the author. |
| 51 | * 'Author' - The author's web site and name. |
| 52 | * 'Version' - The version of the plugin in the file. |
| 53 | * |
| 54 | * @since 2.5.0 |
| 55 | * |
| 56 | * @param string $plugin_file Full Plugin Path |
| 57 | * @return array Plugin's data |
| 58 | */ |