GitHub - spatie/skeleton-nova-tool: A skeleton repository for Spatie's N...
source link: https://github.com/spatie/skeleton-nova-tool
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
Using this skeleton (remove this section after you have completed these steps)
This repo contains a skelton to easily create Nova Tool packages. It contains a few niceties not present in the default Nova Tool scaffolding.
First clone this repo to your development machine and remove the .git
directory. Next run git init
to create another repo. Create a new repo on GitHub (or another source control saas) and point the origin remote of your cloned repo to the one you just created. Here's an example: git remote add origin [email protected]:spatie/newly-created-repo.git
. Commit all files and push to master.
Next replace these variables in all files of your repo:
:author_name
(example: 'Freek Van der Herten'):author_username
(example: 'freekmurze'):author_email
(example: '[email protected]'):package_name
(example: 'nova-tail-tool'):package_description
(example: 'A tool to tail the log'):vendor
(example: 'spatie'):namespace_vendor
(example: 'Spatie'):namespace_tool_name
(example: 'TailTool')
Next run composer install
, yarn
and yarn production
.
To use the tool in a Nova app add this line in the require
section of composer.json
.
":vendor/:package_name": "*",
In your Nova app add a repositiories
section to the composer.json
with the path to your package repo.
"repositories": [
{
"type": "path",
"url": "../:package_name"
},
Now you're ready to develop your package inside a Nova app.
When you are done with the steps above delete everything above!
:package_description
This is where your description should go. Try and limit it to a paragraph or two.
Add a screenshot of the tool here.
Installation
You can install the package in to a Laravel app that uses Nova via composer:
composer require :vendor/:package_name
Next up, you must register the tool with Nova. This is typically done in the tools
method of the NovaServiceProvider
.
// in app/Providers/NovaServiceProvder.php // ... public function tools() { return [ // ... new \:namespace_vendor\:namespace_tool_name\Tool(), ]; }
Usage
Click on the ":package_name" menu item in your Nova app to see the tool provided by this package.
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email :author_email instead of using the issue tracker.
Postcardware
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
We publish all received postcards on our company website.
Credits
Support us
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.
License
The MIT License (MIT). Please see License File for more information.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK