Braunson / fatsecret by BraunsonYager

A PHP FatSecret API library for Laravel
7,059
13
5
Package Data
Maintainer Username: BraunsonYager
Maintainer Contact: braunson@geekybeaver.ca (Braunson Yager)
Package Create Date: 2014-06-12
Package Last Update: 2024-07-06
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-12-22 15:02:30
Package Statistics
Total Downloads: 7,059
Monthly Downloads: 51
Daily Downloads: 0
Total Stars: 13
Total Watchers: 5
Total Forks: 9
Total Open Issues: 0

FatSecret API for Laravel

The FatSecret API for Laravel gives you access to the FatSecret API.

FatSecret provides you with access to comprehensive nutrition data for many thousands of foods, not to mention a range exercises and great weight management tools for your applications.

Looking for 4.x Compatability?

While it may be unsupported now, you can find 4.x compatible versions in the laravel4 branch or tagged with 4.0

How to Install

  1. Install the braunson/fatsecret-laravel package

    $ composer require "braunson/fatsecret-laravel"
    
  2. Update config/app.php to activate FatSecret package

    # Add `FatSecretServiceProvider` to the `providers` array
    'providers' => array(
    	...
    	'Braunson\FatSecret\FatSecretServiceProvider',
    )
    
    # Add the FatSecret Facade to the `aliases` array
    'aliases' => array(
    	...
    	'FatSecret' => 'Braunson\FatSecret\Facade',
    )
    

Configuration

  1. Go to config/services.php and add this in with your details in the provided array

    // API Key & Secret (http://platform.fatsecret.com)
    'fatsecret' => [
        'secret' => env('FATSECRET_SECRET'),
        'key' => env('FATSECRET_KEY'),
    ],
    
  2. Open your .env file and add in

    FATSECRET_SECRET=YOUR-API-SECRET
    FATSECRET_KEY=YOUR-API-KEY
    

Usage

When you are using this package in a file, make sure to add this to the top of your file:

use Fatsecret;

The FatSecret is available as FatSecret, for example:

FatSecret::ProfileCreate($userID, &$token, &$secret);

For more information on using the FatSecret API check out the documentation

Methods

FatSecret::searchIngredients($search_phrase, $page, $maxresults)
  • Search ingredients by phrase, page and max results
FatSecret::getIngredient($ingredient_id)
  • Retrieve an ingredient by ID
FatSecret::GetKey()
  • Gets the set consumer key
FatSecret::SetKey()
  • Allows overriding or setting of the consumer key
FatSecret::GetSecret()
  • Gets the set secret key
FatSecret::SetSecret()
  • Allows overriding or setting of the secret key
FatSecret::ProfileCreate($userID, $token, $secret)
  • Allows creation of a profile in FS with a user specific ID.
FatSecret::ProfileGetAuth($userID, $token, $secret)
  • Get the authentication details of a profile
FatSecret::ProfileRequestScriptSessionKey($auth, $expires, $consumeWithin, $permittedReferrerRegex, $cookie, $sessionKey)
  • Create a new session for JavaScript API users

Reporting Bugs or Feature Requests

Please report any bugs or feature requests on the github issues page for this project here:

https://github.com/braunson/fatsecret/issues

Contributing

License

The FatSecret Laravel API is free software released under the MIT License. See LICENSE for details. This is not an official release and is released separately from FatSecret.