Installation

Install via composer:

composer require bmlt/fetch-meditation

Basic Usage

Here's a basic example of fetching a meditation:

use FetchMeditation\JFTLanguage;
use FetchMeditation\JFTSettings;
use FetchMeditation\JFT;

// Initialize settings with your preferred language
$settings = new JFTSettings(JFTLanguage::English);

// Get JFT instance and fetch today's meditation
$jft = JFT::getInstance($settings);
$data = $jft->fetch();

// Access meditation components:
echo $data->date;      // Today's date
echo $data->title;     // Meditation title
echo $data->page;      // Page reference
echo $data->quote;     // Quote text
echo $data->source;    // Quote source

// Content is an array of paragraphs
foreach ($data->content as $paragraph) {
    echo $paragraph;    // Each paragraph of content
}

echo $data->thought;   // Just for Today thought
echo $data->copyright; // Copyright info

Language Support

The library supports multiple languages:

// Available languages:
$settings = new JFTSettings(JFTLanguage::English);    // English
$settings = new JFTSettings(JFTLanguage::Spanish);    // Spanish
$settings = new JFTSettings(JFTLanguage::French);     // French
$settings = new JFTSettings(JFTLanguage::German);     // German
$settings = new JFTSettings(JFTLanguage::Italian);    // Italian
$settings = new JFTSettings(JFTLanguage::Japanese);   // Japanese
$settings = new JFTSettings(JFTLanguage::Portuguese); // Portuguese
$settings = new JFTSettings(JFTLanguage::Russian);    // Russian
$settings = new JFTSettings(JFTLanguage::Swedish);    // Swedish

Display Example

Here's an example of displaying a complete meditation with HTML formatting:

// Display a complete meditation
$settings = new JFTSettings(JFTLanguage::English);
$jft = JFT::getInstance($settings);
$data = $jft->fetch();

echo "<h1>{$data->title}</h1>\n";
echo "<p><em>{$data->date}</em></p>\n";
echo "<blockquote>{$data->quote}</blockquote>\n";
echo "<cite>{$data->source}</cite>\n";

// Content is an array of paragraphs - display each in its own paragraph
echo "<div class='content'>\n";
foreach ($data->content as $paragraph) {
    echo "  <p>{$paragraph}</p>\n";
}
echo "</div>\n";

echo "<p class='thought'>{$data->thought}</p>\n";
echo "<footer>{$data->copyright}</footer>\n";

Available Methods