Skip to content

Latest commit

 

History

History
137 lines (95 loc) · 3.99 KB

readme.md

File metadata and controls

137 lines (95 loc) · 3.99 KB

Introduction

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.

Installation

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

(optional) Visit https://unsplash.com/oauth/applications to create a new unsplash app. Grab the access key and update config/services.php:

'unsplash' => [
    'key' => 'UNSPLASH_ACCESS_KEY',
],

Updates

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

Themes

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');

Road map

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.

Contributing

Check our contribution guide.

License

Wink is open-sourced software licensed under the MIT license.