Download the PHP package firebrandhq/silverstripe-hail without Composer

On this page you can find all versions of the php package firebrandhq/silverstripe-hail. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Example code of firebrandhq/silverstripe-hail

Informations about the package silverstripe-hail

Hail.to Integration for SilverStripe 4

Silverstripe 4 module to integrate with Hail (https://get.hail.to)

If you need this module for SilverStripe 3 please refer to this branch.

:exclamation: If you are getting errors while fetching, please update to 4.2 version

Features

Requirements

For SilverStripe 4.1 to 4.3 use version 4.2.1

Upgrade from older versions

This module has been re written for SilverStripe 4 and includes breaking changes compared to previous version. Please perform a fresh install if you are upgrading from previous versions by removing and re installing the module.

Installation

Run the following command:

(Optional) Enable Emojis Support (has to be done before doing the dev/build):

See Emojis Support configuration

Install Silverstripe Sake:

Please ensure sake is using php ^7.1

Perform a dev/build

Add the following lines (adapt them to your environment) to your crontab:

You need to add those jobs to the cronjob of the user running your webserver (example on Ubuntu with apache2: sudo crontab -e -u www-data)

You can adapt the frequency of the hail-fetch-recurring job to your needs, it will always fetch up until previous fetch

Authorize Silverstripe to fetch from Hail:

  1. Go to hail.to and signin, then go to your Developer Settings (https://hail.to/app/user/applications) and create a new application (Add new button)

  2. Add the generated Hail Client ID and Client Secret to your .env file:

  3. Go to SilverStripe admin settings page (/admin/settings/), then on the Hail tab
  4. Copy the Callback URL
  5. Back to the Hail Developer Settings, Click "Add new" in the redirect URI section and paste the Callback URL
  6. You are now ready to authorize your Hail application, go back to the SilverStripe Admin settings and click the "Authorise SilverStripe to Access Hail" button.
  7. After the authorization process is complete, you will be able to select the Hail Organisation(s) you want to fetch content from in the Admin Settings of SilverStripe.
  8. (Optional) You can globally exclude content with specific Public or Private tags in the Admin Settings of SilverStripe
  9. Save your Admin Settings

You can now either wait for your cron job to fetch the content or force a full fetch from the Hail menu in SilverStripe CMS using the Fetch button (top left in the page).

jQuery and Bootstrap requirements

We include jQuery 3.3.1 and Bootstrap 4.1 (javascript and css) in our Hail Page and Hail Articles by default.

If you need to include your own jQuery and/or Bootstrap (If you compiled Bootstrap from source or want to include those globally for example), simply block our requirement(s) by adding one or all the following to your PageController init() function:

Configuration

The following yml configuration options are available for override:

Hail API Client configuration:

Default configuration:

Hail Page Controller configuration:

Default configuration:

Hail Recurring Fetch Task configuration:

Default configuration:

In order to override those values you need to add a new yml file into your mysite/_config/ folder, specifying that your configuration needs to be included after Hail's.

Example yml config file:

Usage

Once everything is configured and your Hail content is fetched you can create a Hail Page in the SilverStripe CMS to display the content on your website. The configuration of the Hail Page should be self explanatory, see screenshots below:

Hail Page configuration:

Once configured and published your Hail Page should look like this (using default styles and templates):

Emojis Support

IMPORTANT: Enabling Emojis Support will change the charset and collation of your SilverStripe database to utf8mb4 and utf8mb4_general_ci respectively.

utf8mb4 is backward compatible with utf8 so it should work with any existing or new database, we still chose to disable the feature to avoid imposing this change.

To enable Emojis support please add the following to your SilverStripe yml (following the example below) config and perform a dev/build.

Example yml config file:

OpenGraph Support

Open Graph support is now directly included in this module, provided you use Tractorcow's module for OG

If you wish to modify our OG implementation for Hail pages / articles, you can use SilverStripe injection to do so.

SilverStripe Elemental Support

We offer a pre built SilverStripe Elemental block (Hail Carousel) for you to use:

See Hail Elemental module for installation instructions

Contributing

See CONTRIBUTING.md

Versioning

This library follows Semver. According to Semver, you will be able to upgrade to any minor or patch version of this library without any breaking changes to the public API. Semver also requires that we clearly define the public API for this library.

All methods, with public visibility, are part of the public API. All other methods are not part of the public API. Where possible, we'll try to keep protected methods backwards-compatible in minor/patch versions, but if you're overriding methods then please test your work before upgrading.

Reporting Issues

Please create an issue for any bugs you've found, or features you're missing.

All versions of silverstripe-hail with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
silverstripe/cms Version ^5.0
silverstripe/framework Version ^5.0
silverstripe/environmentcheck Version ^3.0
guzzlehttp/guzzle Version ^7
symfony/console Version ^6.1
composer-plugin-api Version ^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package firebrandhq/silverstripe-hail contains the following files

Loading the files please wait ....