Download the PHP package justintadlock/hybrid-carbon without Composer
On this page you can find all versions of the php package justintadlock/hybrid-carbon. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download justintadlock/hybrid-carbon
More information about justintadlock/hybrid-carbon
Files in justintadlock/hybrid-carbon
Package hybrid-carbon
Short Description God-like post featured image script.
License GPL-2.0-or-later
Homepage https://github.com/justintadlock/hybrid-carbon
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package hybrid-carbon
Hybrid\Carbon
Post featured image script with magical properties.
Hybrid Carbon is a drop-in library. It is not a standalone plugin and should be included in any themes/plugins that you ship.
This is a refresh of the original Get the Image project to make it more suitable for including in both plugins and themes as a drop-in package. It's also a way to shed some of the 10+ years of baggage from the original plugin.
Hybrid Carbon is meant to replace the core WP featured image (i.e., post thumbnail) feature with a version that has a few more possibilities. Out of the box, it comes with 4 methods for locating featured images:
featured- This is the normal featured/thumbnail image.attached- Searches for the first image uploaded/attached to a post.meta- Searches for an image (attachment ID) assigned to a custom meta field.scan- Scans the post content for image attachment IDs.
All of the core script methods are based around core WP's image attachment feature so that we can utilize the built-in functions already available like responsive images using srcset and sizes.
Requirements
- PHP 5.6+ (preferably 7+)
- Composer for managing PHP dependencies.
Documentation
The script should be relatively easy to use if you've ever worked with featured images in WP. There's not a lot of code to change. The following docs are written with theme authors in mind because that'll be the most common use case. If including in a plugin, it shouldn't be much different.
Installation
First, you'll need to open your command line tool and change directories to your theme folder.
Then, use Composer to install the package.
Assuming you're not already including the Composer autoload file for your theme and are shipping this as part of your theme package, you'll want something like the following bit of code in your theme's functions.php to autoload this package (and any others).
The Composer autoload file will automatically load up Hybrid Carbon for you and make its code available for you to use.
Usage
Most developers will want to utilize the Hybrid\Carbon\Image class. It is a static wrapper class that essentially acts as syntactic sugar for use in theme templates.
Typically, you'd want to replace any calls to the_post_thumbnail() inside of The Loop in your theme templates like so:
Note that the plugin's namespace is Hybrid\Carbon. If you're working within another namespace, you'll want to add a use statement after your own namespace call or call \Hybrid\Carbon\display() directly. I'll assume you know what you're doing if you're working with namespaces. Otherwise, stick to the above.
Parameters
There are two parameters: $type and $args.
$type
The $type parameter accepts a string of a single type or an array of types. A type is just the method to use to locate a featured image.
The following are the built-in types:
featured- This is the normal featured/thumbnail image.attached- Searches for the first image uploaded/attached to a post.meta- Searches for an image (attachment ID) assigned to a custom meta field. Must be coupled with ameta_keyset in$args.scan- Scans the post content for image attachment IDs.
If passing in an array of types, the script will search for images in the order that you add them.
$args
The $args parameter is an optional array of arguments to customize the image.
post_id- ID of the post to get the image for (defaults to current post).size- Size of the image to get.meta_key- String or array of meta keys to search for (value must be an attachment ID).class- Class applied to the image.link- Whether to link to the post.link_class- Class applied to the link.min_width- Minimum width required of the image.min_height- Minimum height required of the image.attr- Array of image attributes.caption- Whether to include captions for images that have them (defaults tofalse).before- HTML string to add before the output of the image.after- HTML string to add after the output of the image.
Static helper class
The following methods are available for the Hybrid\Carbon\Image class.
