PHP download

Download the PHP package ernestdefoe/theme-toggle without Composer

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

Table of contents
Download ernestdefoe/theme-toggle
More information about ernestdefoe/theme-toggle
Files in ernestdefoe/theme-toggle

Vendor ernestdefoe
Package theme-toggle
Short Description Adds a day/night/system toggle button to the Flarum 2 header. Works with any theme via the native data-theme attribute.
License MIT
Homepage https://github.com/ernestdefoe/theme-toggle

Keywords theme toggle flarum flarum-extension dark-mode light-mode

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 ernestdefoe/theme-toggle

Informations about the package theme-toggle

Theme Toggle

A small, theme-agnostic day/night/system picker for the Flarum 2 header. Drops into any Flarum 2 theme that respects the native <html data-theme="…"> signal (every theme that ships with or extends Flarum 2 does, including the default).

Screenshots

Desktop — header button

A compact icon button next to Search / Sign Up / Log In. The icon reflects the active choice (☾ dark, ☀ light, ◐ system).

Desktop — dropdown open

Five choices, each with a matching icon. The active choice is marked with a checkmark.

Mobile — slide-out drawer

On phone-width viewports Flarum re-renders HeaderSecondary inside .App-drawer. The button switches to a labeled, full-width menu row so it lines up with Search / Sign Up / Log In.

Features

Five choices. Dark, Dark (high contrast), Light, Light (high contrast), System.
Native Flarum 2 signal. The extension only flips <html data-theme="…"> and localStorage — no theme-specific CSS, so it composes with any well-behaved Flarum 2 theme (default, Aurora, or any third-party theme).
System mode honours OS preferences. When System is active, the theme follows prefers-color-scheme for light/dark and prefers-contrast: more for the -hc variants — so an accessibility user with macOS / Windows "Increase contrast" turned on automatically gets the right palette.
Live OS updates. Changes to the OS theme or contrast preference are picked up immediately while the tab is open, with no reload.
Persists per visitor. Your choice is stored in localStorage under ernestdefoe-theme-toggle.choice and re-applied on every page load before paint, so there's no FOUC.
Respects the admin default. Until a visitor explicitly picks a choice, Flarum's Admin → Appearance → Color Scheme setting is left untouched.
Mobile-aware UI. Renders as a compact icon button in the desktop header and as a labeled "◐ Theme" row inside the mobile slide-out drawer (where icon-only buttons would float disconnected from the surrounding Sign Up / Log In rows).
Localized. All visible strings come from locale/en.yml and can be overridden in your forum's locale files.
TypeScript end-to-end. Sources are authored in TypeScript and type-checked against Flarum core's bundled .d.ts files. npm run check-typings runs tsc --noEmit.

Compatibility

Flarum core ^2.0
PHP ^8.3
Pairs with any theme. Tested with the default theme and the Aurora theme.

Install

Then enable Theme Toggle from the admin panel's Extensions page.

Development

The TypeScript path mapping in js/tsconfig.json points at ../vendor/flarum/core/js/dist-typings/, so composer install at the repo root must run before check-typings can resolve flarum/* imports.

Project layout

How it works

Flarum 2 ships four data-theme values: light, light-hc, dark, and dark-hc. Themes are expected to define their dark tokens as the default and their light tokens under [data-theme^='light'], with a high-contrast layer under [data-theme^='light-hc'] / [data-theme^='dark-hc']. Because those selectors use ^= (prefix match), setting data-theme="light-hc" activates both the regular light palette and its HC overrides via the cascade.

This extension just sets that attribute client-side:

On boot, theme.ts reads the saved choice from localStorage and writes the corresponding string to <html data-theme="…"> before the initializer runs, so the page never paints in the wrong palette.
The ThemeToggle component reads the same choice for its icon and dropdown state.
When the user picks a new option, the choice is written to localStorage, <html> is updated, and Mithril redraws the button.
In System mode, a matchMedia listener for prefers-color-scheme and prefers-contrast: more re-applies the choice live.

No theme-specific CSS, no setting payload, no server round-trip.

Translations

Override any string by adding the matching key under ernestdefoe-theme-toggle.forum.toggle.* in your forum's locale file:

Key	Default
`label`	`Theme`
`option_dark`	`Dark`
`option_dark_hc`	`Dark (high contrast)`
`option_light`	`Light`
`option_light_hc`	`Light (high contrast)`
`option_system`	`System`

License

All versions of theme-toggle with dependencies

PHP Build Version

Package Version

Version 3.0.10 Release 05. Jun 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of theme-toggle from vendor ernestdefoe

Requires php Version ^8.3
flarum/core 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 ernestdefoe/theme-toggle contains the following files

Loading the files please wait ...