PHP download

Download the PHP package lex-zander/kirby-karbon without Composer

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

Table of contents
Download lex-zander/kirby-karbon
More information about lex-zander/kirby-karbon
Files in lex-zander/kirby-karbon

Vendor lex-zander
Package kirby-karbon
Short Description Serves a carbon.txt for Kirby sites, editable in the Panel
License MIT

Keywords kirby kirby-plugin sustainability carbon.txt green-web

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?

Informations about the package kirby-karbon

Kirby Karbon

Serves a carbon.txt for your Kirby site, editable in the Panel.

Editors keep the data in the Panel. The plugin turns it into a valid carbon.txt (syntax version 0.5) at /carbon.txt and /.well-known/carbon.txt.

carbon.txt is a small, machine-readable file that points to your organisation's sustainability disclosures and lists the providers your site runs on. Tools such as the Green Web Foundation read it to verify green hosting claims.

Installation

Composer

Manual

Download the plugin and copy it to site/plugins/karbon.

Setup

Add the plugin's tab to your site blueprint, site/blueprints/site.yml:

The Panel then shows a carbon.txt tab on the site page with these fields:

Field	Written to carbon.txt as	Notes
Last updated	`last_updated`	Read-only. Set automatically, see below.
Disclosures	`[org] disclosures`	Document type and URL are required. Domain, valid until and title are optional.
Upstream services	`[upstream] services`	Domain is required. Service type is optional and can have several values.

Output

With a few entries, /carbon.txt looks like this:

You can check the result with the carbon.txt validator.

How it behaves

Last updated is set to the current date whenever the disclosures or upstream services change. Other edits on the site page don't touch it. Until the carbon.txt data is saved for the first time, the field is empty and last_updated is left out of the file.
Incomplete entries are skipped instead of producing an invalid file. A disclosure needs a document type and an absolute http:// or https:// URL. A service needs a domain.
Domains are cleaned up. https://www.example.com/path becomes www.example.com, as the spec expects a domain without protocol or path.
Invalid dates are left out. A valid_until that isn't a real date is dropped rather than written as a wrong one.
Multi-language sites: the fields are not translatable. carbon.txt describes the organisation, not a language version, so it's the same for every language. Edit it in the default language.

Good to know

A physical carbon.txt wins. If a file named carbon.txt exists in your web root, your web server delivers it directly and the plugin's route is never reached. Delete the file to use the plugin.
/.well-known/ on nginx: some nginx configurations block all paths that start with a dot. If /.well-known/carbon.txt returns a 403 or 404, allow .well-known in your server config, or use /carbon.txt.
Panel languages: the Panel labels are translated into English and German. Other Panel languages currently show the raw translation keys.

Support

Kirby Karbon is free. If it's useful to you, you can support its development on Ko-fi.

License

MIT

All versions of kirby-karbon with dependencies

PHP Build Version

Package Version

Version v1.0.1 Release 28. Sep 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of kirby-karbon from vendor lex-zander

Requires php Version >=8.2
getkirby/composer-installer Version ^1.1

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 lex-zander/kirby-karbon contains the following files

Loading the files please wait ...