Download the PHP package tournasdim/laravel4-getgravatar without Composer
On this page you can find all versions of the php package tournasdim/laravel4-getgravatar. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tournasdim/laravel4-getgravatar
More information about tournasdim/laravel4-getgravatar
Files in tournasdim/laravel4-getgravatar
Package laravel4-getgravatar
Short Description A Laravel 4 package . Given an email address it automatically retrieves an Avatar from Gravatar's website . For logged-in users , their email address is automatically generated , through the Auth adapter Interface . Three Adapters are supported : Auth , Sentry and Confide .
License MIT
Homepage https://github.com/tournasdim/getgravatar
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 laravel4-getgravatar
Laravel4-Getgravatar
An avatar is a graphical representation of a user . It could be the person’s picture , or a random icon they want to be associated with . All a user has to do is to register an account based on their email address and upload an avatar to associate with that account . On the other side of the coin , webmasters that want to let their visitors graphically identify themselves have to implement a REST request to Gravatar's API . The request is just an URL encoded string with the email address of the user . If Gravatar's servers recognize this email address as a registered user , the user's associated Avatar is send back . Webmasters can also configure their system to automatically display an Identicon when a user has no registered Gravatar . This library is meant to be used as a Laravel 4.0 / 4.1 package and help PHP developers be concentrated on more important parts of their Laravel project .
Prerequisites :
It is assumed that you already have a working Laravel 4 project . Basic knowledge with Laravel's concepts are also required . For instance : Route , Controller , Blade or Authentication-adapter shouldn't be "strange" words to you .
Installation :
-
1) Update your Laravel's
composer.jsonfile - 2) Run a
composer updatecommand from your project's root - 3) Add the Gravatar Service Provider and an alias to your configuration file
app/config/app.php:
`
- 4) Optionally "transfer" the configuration file of this package into "app/config/packages" directory . This will give you the option to customize basic features of this package . Run
php artisan config:publish "tournasdim/laravel4-getgravatar"and open the file "app/config/packages/tournasdim/getgravatar/config.php" to customize basic functionality (size , customGravUrl , defGrav , authAdapter , maxRating) . Every option is explained in the configuration file , drop me an issue if you need specific help though .
Un-Installing the package :
- Remove this package's registration from Laravel's
composer.jsonfile - Remove Gravatar Service Provider from config file
app/config/app.php - Remove the alias from the config file
app/config/app.php - If step 4 of the installation process was implemented , manually remove the
"tournasdim" directory from
app/config/packagesdirectory . Instead of manually removing this directory , alternatively use the CLI :php artisan gravatar:uninstall - Run a
composer updatecommand .
Basic usage :
The "Gravar" Class accepts three optional parameters .
- $size : Expresed in pixels , if defined then it will overwrite the value defined into the configuration file .
- $randomize : This feature is enabled by default ,the Class will randomly select a name from a Pool of accepted names ('mm' , 'identicon' , 'monsterid' , 'wavatar' , 'retro') . If the email send to Gravatar's server is not recognized then this specified Avatar will be returned instead . By setting the value of this option to "false" , random is turned off , and the value of
defGravwill be used as parameter (a predefined fallback avatar) . - $email : Default is set to null . Logged-in user's email is resolved by using the current Auth's adaptor Interface . Which adapter is currently used by the application is defined into a key ("authAdapter") of the configuration file . By specifying an email , we actualy force the Class to use this as value into the query string . This feature is handy for non registered users , we will use their specified email (on comment sections) to build our query string .
- Another important configuration option is made directly into the configuration file "app/config/packages/tournasdim/getgravatar/config.php" (supposed that step 4 of the installation process was applied ) . If you'd prefer to use your own default fallback-image (perhaps your logo , a funny face , whatever), then you can easily do so by supplying a custom URL to an image . Just set your prefered Url into the "customGravUrl" variable of this package's configuration file . If the email send to Gravatar's server is not recognized , an image from the custom Url will be returned instead . Keep in mind though that the "size" attribute isn't active anymore because Gravatar's server won't crop our custom image (make sure you have uploaded the right size for the custom fallback image) .
Practical examples :
Calling an Avatar from a Route
-
Example 1 :
-
Example 2 :
-
Example 3 :
- Example 4 :
Calling an Avatar from a Controller
-
Example 1 :
- Example 2 :
Calling an Avatar from Controller's constructor
- Example 1 :
Where to get help :
Open a new issue on this repository and I'll try to help . Please limit your question(s) only to issues related to this project . Laravel's forums / IRC are more suited places to get general information about the Framework . Reports about bugs are welcome , but also , I would be glad to hear about your experience and suggestions of this repository .
Special thanks to :
Of course the creator of the Laravel Framework (Taylor Otwell) and all active members of Laravel's forum / IRC channel .
Things to do :
- Based on user's feedback , improvements will be applied accordingly .
- Users may optionally enter a variety of profile information to associate with their Gravatar account. This information is openly-accessible by Gravatar's API . Probably , a future release of this package will implement this functionality .
- Completing the Unit testing Class
Tools used during development :
- An headless Linux box (CentOs 6) as web-server (Apache 2 , PHP5.4)
- Sublime Text 2 (Free version)
- Phing for automated deployment to GitHub and for FTP to the Linux box
- Git-Bash for versioning of the code
- Windows 7 with WAMP stack (Apache2.2.2 , PHP5.4.3)
License :
Getgravatar
@copyright Tournas Dimitiros 2013
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
@author Tournas Dimitrios [email protected] @version V1.0.0
