Download the PHP package godbout/alfred-workflow-workflow without Composer

On this page you can find all versions of the php package godbout/alfred-workflow-workflow. 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 godbout/alfred-workflow-workflow

Informations about the package alfred-workflow-workflow

PHP Alfred Workflow Workflow

Latest Stable Version Build Status Quality Score Code Coverage Total Downloads

Tired of writing the same code over and over just to get your new Workflow up and running? Yeah me too.

DOUBLE WHAMMY WORKFLOW

An Alfred Workflow does only two things: 

1. show results  
2. do an action  
2.5. ok send a notification, maybe

which means, why typing over and over those same stuff over and over. I say stop to wasting keyboard keys. (Even more if you work on a MacBook because the keyboard will break soon.)

BUT WTF IS THAT, REALLY

Basically it's a set of base classes and some conventions and an Alfred Workflow Skeleton to get you up in no time. Follow the conventions and all you have to do is create your Menus, and your Actions. All the boring rest is handled by the Skeleton, and this package. The common glue is taken care of. You focus only on the specificity of your Workflow.

Installation

The Conventions

Well this is where it gets interesting, because i'm still not sure how to express it. Best currently is to go through different use cases together. See the three cases below.

Case 1: Alfred Ploi

This is the most straightforward Workflow. It doesn't override anything so it follows all the conventions, and only defines what it specifically needs.

  1. Your Workflow Class only needs to define the possible actions of the Workflow: https://github.com/godbout/alfred-ploi/blob/0.1.0/src/Workflow.php
  2. Your Entrance Menu Class defines what should be shown to the Alfred user when they start the Workflow: https://github.com/godbout/alfred-ploi/blob/0.1.0/src/Menus/Entrance.php. Entrance is a convention for the first Menu of your Workflow (although you can name it whatever you want, but then you need to override the currentMenu method. See Alfred Time below). All other Menus can be called whatever you want, as they will be defined as args of your Menu Items.
  3. The script called by Alfred only checks whether you're showing a Menu or calling an Action: https://github.com/godbout/alfred-ploi/blob/0.1.0/src/app.php

That's it. Just pass the right args and variables according to the conventions and it just works.

Check the Alfred Ploi Workflow for the Workflow Skeleton: https://github.com/godbout/alfred-ploi/releases/tag/0.1.0

Case 2: Alfred Kat

This Workflow overrides only the do and notify methods.

  1. The do method needs a specific argument, so it is overriden: https://github.com/godbout/alfred-kat/tree/4.1.0/src/Workflow.php#L10
  2. The notify method needs to send different notifications, so it is overriden too: https://github.com/godbout/alfred-kat/tree/4.1.0/src/Workflow.php#L21
  3. The Menus (only one in this case) are not overriden: https://github.com/godbout/alfred-kat/tree/4.1.0/src/Menus/Entrance.php

All the rest of the wiring is handled by this package, and the Alfred Workflow Skeleton: https://github.com/godbout/alfred-kat/releases/tag/4.1.0

Case 3: Alfred Time

This is the hardest one. It overrides:

  1. The do method, passing an argument, sometimes: https://github.com/godbout/alfred-time/blob/3.0.0/src/Workflow.php#L37
  2. The notify method, for custom messages: https://github.com/godbout/alfred-time/blob/3.0.0/src/Workflow.php#L52
  3. The way Menus are loaded, because in this Workflow, Menus are arranged in specific (Timer Services) folders: https://github.com/godbout/alfred-time/blob/3.0.0/src/Workflow.php#L30

And yet, even in this case, most of the code is just specific code for this particular Workflow. Most of the Alfred wiring is handled by this package, and the Workflow Skeleton: https://github.com/godbout/alfred-time/releases/tag/3.0.0

Args and Variables

So, a Workflow does two things:

  1. show a Menu
  2. do an Action

How do you tell Alfred which Menu to show or which Action to run? Through the args and variables.

For example, in your Entrance Menu Class, you show a menu:

Alfred will then call your src/Menus/ChooseProject.class Class and its scriptFilter method, where you design what appears in your next Menu.

Any arg that is different than do is taken as a Menu, loaded from the src/Menus folder (with the default convention, as see with Alfred-Time, you can override how/where the Menus are loaded).

To do an Action:

For the first item, Alfred will call your Workflow Class and its deleteFile method. For the second item, the copyFile method.

For a simple example, see the Alfred Ploi Workflow source again.

All versions of alfred-workflow-workflow with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0.2
godbout/alfred-workflow-scriptfilter Version ^2.4
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 godbout/alfred-workflow-workflow contains the following files

Loading the files please wait ....