Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spicywebau/craft-odds-and-ends
A repo of useful tools for Craft CMS websites
https://github.com/spicywebau/craft-odds-and-ends
craft craft-plugin craft3 craft4 craftcms
Last synced: 7 days ago
JSON representation
A repo of useful tools for Craft CMS websites
- Host: GitHub
- URL: https://github.com/spicywebau/craft-odds-and-ends
- Owner: spicywebau
- License: mit
- Created: 2015-08-27T07:59:16.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-07-15T16:38:16.000Z (6 months ago)
- Last Synced: 2025-01-04T12:52:56.636Z (14 days ago)
- Topics: craft, craft-plugin, craft3, craft4, craftcms
- Language: PHP
- Homepage:
- Size: 767 KB
- Stars: 53
- Watchers: 7
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Odds & Ends
A collection of useful tools for Craft CMS websites.
## Field types
### Width
This lets you define the width of a block as well as left and right padding. This field simply outputs three sets of classes which can be defined when setting the field up.
### Author Instructions
This lets you output markdown instead of a field, which is useful when you have a Matrix block that doesn’t have any fields.
### Categories (multiple groups)
A Categories input that lets you select multiple Category groups.
### Ancestors
An Entries input that only shows the ancestors of the current Entry.
### Search Fields
Like the Tags input, but for entries and categories (without the auto-creation feature). If Craft Commerce is installed, search fields for products and variants are also available.
### Disabled Fields
The same as regular fields, but disabled. Useful for situations where you want to integrate with a third party API and store that information in a field but don’t want the user to change it.
The following field types are currently supported:
- Entries
- Categories
- Lightswitch
- Number
- PlainText
- Dropdown
- Commerce Products
- Commerce Variants
## Widgets
### Roll Your Own
A simple widget that lets you assign a template to load from your site templates folder. Go nuts.
## Miscellaneous
### Download File
A controller action that will download an asset file.
The `id` parameter is required and must be a valid asset ID.
Usage:
```
Download
```
## Configuration
By default, all normal field types and widgets are enabled.
The commerce field types are only enabled if Craft Commerce is installed and enabled.
You can disable each field type and widget by adding the following to your project's `config/tools.php` file:
```php
use spicyweb\oddsandends\fields\AuthorInstructions;
use spicyweb\oddsandends\fields\DisabledProducts;
use spicyweb\oddsandends\widgets\RollYourOwn;
return [
'disableNormalFields' => [
AuthorInstructions::class,
],
'disableCommerceFields' => [
DisabledProducts::class,
],
'disableWidgets' => [
RollYourOwn::class,
],
];
```
Multi environment config is supported. See [Craft's docs](https://craftcms.com/docs/4.x/config/#multi-environment-configs) for more info.
See `config/tools.php` in this repo for an example on how to disable any field and widget.
---
*Created by [Supercool](https://supercooldesign.co.uk)*
*Maintained by [Spicy Web](https://spicyweb.com.au)*