Wink's only job is to help you write and present your content with style. Wink is built on top of the world's finest PHP framework Laravel, making it easy for everyone to install and maintain on any cloud platform.
Wink runs on any Laravel application, it uses a separate database connection and authentication system so that you don't have to modify any of your project code.
To install Wink, require it via Composer:
composer require writingink/wink
Once Composer is done, run the following command:
php artisan wink:install
Check config/wink.php
and configure the database connection wink is going to be using. Then instead of running php artisan migrate
, run:
php artisan wink:migrate
Head to yourproject.test/wink
and use the provided email and password to log in.
Before creating a blog post, make sure you have your image directory set up correctly. The directory is set in the config/wink.php
and defaults to
public/wink/images
. If you are installing Wink in a fresh Laravel install, make sure you link your public directory to the storage directory https://laravel.com/docs/5.7/filesystem#configuration using this command:
php artisan storage:link
If you want to upload images to S3 with cache-control header, add CacheControl
option in config/filesystems.php
. Also, you can specify CDN base url such as CloudFront.
's3' => [
'driver' => 's3',
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'region' => env('AWS_DEFAULT_REGION'),
'bucket' => env('AWS_BUCKET'),
'url' => env('CDN_URL'),
'options' => [
'CacheControl' => 'public, max-age=315360000'
],
],
(optional) Visit https://unsplash.com/oauth/applications to create a new unsplash app. Grab the 'Access Key' and add it to your .env
file as UNSPLASH_ACCESS_KEY
. Lastly, add unsplash to your config/services.php
file:
'unsplash' => [
'key' => env('UNSPLASH_ACCESS_KEY'),
],
Add this command in your deployment script so that wink runs new migrations if any:
php artisan wink:migrate
You may also want to run this command to re-publish the assets:
php artisan vendor:publish --tag=wink-assets --force
Wink is shipped with an admin panel that's simple to use. However, we give you full control of how you present the stored content in your interface. Here's an example of how you'd get a list of your posts for a blog home screen:
use Wink\WinkPost;
public function index()
{
$posts = WinkPost::with('tags')
->live()
->orderBy('publish_date', 'DESC')
->simplePaginate(12);
return view('blog.index', [
'posts' => $posts
]);
}
You can configure your routes in any way you want:
Route::get('/', 'BlogController@index');
// OR
Route::get('/blog', 'BlogController@index');
// OR
Route::domain('blog.mywebsite.com')->get('/', 'BlogController@index');
// And for showing a post
Route::get('/{tag}/{slug}', 'BlogController@post');
// OR
Route::get('/{year}/{month}/{slug}', 'BlogController@post');
Wink is still under heavy development, I decided to ship it in this early stage so you can help me make it better, however I'm already using it to run multiple websites including my personal blog.
Here's the plan for what's coming:
- Customize Twitter/Facebook cards and SEO metadata.
- Optimize CSS. Move to Tailwind?
- Add text search inside listings.
- Filter posts by status, scheduling, tags, and authors
- Dark mode.
- Enhance publishing date picker.
- Create an initial theme that people can use right away. @themsaid
- Optimize image uploads and allow cropping.
- Adding image galleries to posts and pages. @themsaid
- Add tests.
And here are some ideas I'm still not sure about:
- Email Subscription & auto send emails on new content.
- Configure roles (Contributor / Admin)
- Localization
- Multi-lingual content
- Attach metadata to posts and pages.
Check our contribution guide.
Wink is open-sourced software licensed under the MIT license.