first

Author: taylorotwell

.gitattributes

@@ -0,0 +1 @@
+* text=auto

.gitignore

@@ -0,0 +1,11 @@
+/vendor
+/resources/docs
+/public/api
+/build/sami/build
+/build/sami/cache
+/node_modules
+composer.phar
+composer.lock
+.env.*
+.DS_Store
+Thumbs.db

app/Console/InspireCommand.php

@@ -0,0 +1,44 @@
+<?php namespace App\Console;
+
+use Illuminate\Console\Command;
+use Illuminate\Foundation\Inspiring;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Input\InputArgument;
+
+class InspireCommand extends Command {
+
+	/**
+	 * The console command name.
+	 *
+	 * @var string
+	 */
+	protected $name = 'inspire';
+
+	/**
+	 * The console command description.
+	 *
+	 * @var string
+	 */
+	protected $description = 'Display an inspiring quote';
+
+	/**
+	 * Create a new command instance.
+	 *
+	 * @return void
+	 */
+	public function __construct()
+	{
+		parent::__construct();
+	}
+
+	/**
+	 * Execute the console command.
+	 *
+	 * @return mixed
+	 */
+	public function fire()
+	{
+		$this->comment(PHP_EOL.Inspiring::quote().PHP_EOL);
+	}
+
+}

app/Documentation.php

@@ -0,0 +1,62 @@
+<?php namespace App;
+
+use Illuminate\Contracts\Cache\Cache;
+use Illuminate\Contracts\Filesystem\Filesystem;
+
+class Documentation {
+
+	/**
+	 * The filesystem implementation.
+	 *
+	 * @var Filesystem
+	 */
+	protected $files;
+
+	/**
+	 * The cache implementation.
+	 *
+	 * @var Cache
+	 */
+	protected $cache;
+
+	/**
+	 * Create a new documentation instance.
+	 *
+	 * @param  Filesystem  $files
+	 * @param  Cache  $cache
+	 * @return void
+	 */
+	public function __construct(Filesystem $files, Cache $cache)
+	{
+		$this->files = $files;
+		$this->cache = $cache;
+	}
+
+	/**
+	 * Get the documentation index page.
+	 *
+	 * @param  string  $version
+	 * @return string
+	 */
+	public function getIndex($version)
+	{
+		return $this->cache->remember('docs.'.$version.'.index', 5, function() use ($version) {
+			return markdown($this->files->get('resources/docs/'.$version.'/documentation.md'));
+		});
+	}
+
+	/**
+	 * Get the given documentation page.
+	 *
+	 * @param  string  $version
+	 * @param  string  $page
+	 * @return string
+	 */
+	public function get($version, $page)
+	{
+		return $this->cache->remember('docs.'.$version.'.'.$page, 5, function() use ($version, $page) {
+			return markdown($this->files->get('resources/docs/'.$version.'/'.$page.'.md'));
+		});
+	}
+
+}

app/Http/Controllers/DocsController.php

@@ -0,0 +1,83 @@
+<?php namespace App\Http\Controllers;
+
+use App\Documentation;
+use Illuminate\Routing\Controller;
+use Illuminate\Contracts\Cache\Cache;
+use Illuminate\Contracts\Filesystem\Filesystem;
+
+class DocsController extends Controller {
+
+	/**
+	 * The documentation repository.
+	 *
+	 * @var Documentation
+	 */
+	protected $docs;
+
+	/**
+	 * Create a new controller instance.
+	 *
+	 * @param  Documentation  $docs
+	 * @return void
+	 */
+	public function __construct(Documentation $docs)
+	{
+		$this->docs = $docs;
+	}
+
+	/**
+	 * Show the root documentation page (/docs).
+	 *
+	 * @return Response
+	 */
+	public function showRootPage()
+	{
+		return redirect(url('docs/'.DEFAULT_VERSION));
+	}
+
+	/**
+	 * Show a documentation page.
+	 *
+	 * @return Response
+	 */
+	public function show($version, $page = null)
+	{
+		if ( ! $this->isVersion($version)) {
+			return redirect(url('docs/'.DEFAULT_VERSION.'/'.$version));
+		}
+
+		return view('layouts.docs', [
+			'index' => $this->docs->getIndex($version),
+			'content' => $this->docs->get($version, $page ?: 'introduction'),
+			'currentVersion' => $version,
+			'versions' => $this->getDocVersions(),
+		]);
+	}
+
+	/**
+	 * Determine if the given URL segment is a valid version.
+	 *
+	 * @param  string  $version
+	 * @return bool
+	 */
+	protected function isVersion($version)
+	{
+		return in_array($version, ['dev', '5.0', '4.2', '4.1', '4.0']);
+	}
+
+	/**
+	 * Get the available documentation versions.
+	 *
+	 * @return array
+	 */
+	protected function getDocVersions()
+	{
+		return [
+			'master' => 'Dev',
+			'4.2' => '4.2',
+			'4.1' => '4.1',
+			'4.0' => '4.0',
+		];
+	}
+
+}

app/Http/Controllers/HomeController.php

@@ -0,0 +1,25 @@
+<?php namespace App\Http\Controllers;
+
+use Illuminate\Routing\Controller;
+
+class HomeController extends Controller {
+
+	/*
+	|--------------------------------------------------------------------------
+	| Default Home Controller
+	|--------------------------------------------------------------------------
+	|
+	| You may wish to use controllers instead of, or in addition to, Closure
+	| based routes. That's great! Here is an example controller method to
+	| get you started. To route to this controller, just add the route:
+	|
+	|	Route::get('/', 'HomeController@index');
+	|
+	*/
+
+	public function index()
+	{
+		return view('hello');
+	}
+
+}

app/Http/Filters/AuthFilter.php

@@ -0,0 +1,31 @@
+<?php namespace App\Http\Filters;
+
+use Illuminate\Http\Request;
+use Illuminate\Routing\Route;
+use Auth, Redirect, Response;
+
+class AuthFilter {
+
+	/**
+	 * Run the request filter.
+	 *
+	 * @param  \Illuminate\Routing\Route  $route
+	 * @param  \Illuminate\Http\Request  $request
+	 * @return mixed
+	 */
+	public function filter(Route $route, Request $request)
+	{
+		if (Auth::guest())
+		{
+			if ($request->ajax())
+			{
+				return Response::make('Unauthorized', 401);
+			}
+			else
+			{
+				return Redirect::guest('auth/login');
+			}
+		}
+	}
+
+}

app/Http/Filters/BasicAuthFilter.php

@@ -0,0 +1,17 @@
+<?php namespace App\Http\Filters;
+
+use Auth;
+
+class BasicAuthFilter {
+
+	/**
+	 * Run the request filter.
+	 *
+	 * @return mixed
+	 */
+	public function filter()
+	{
+		return Auth::basic();
+	}
+
+}

app/Http/Filters/CsrfFilter.php

@@ -0,0 +1,27 @@
+<?php namespace App\Http\Filters;
+
+use Session;
+use Illuminate\Http\Request;
+use Illuminate\Routing\Route;
+use Illuminate\Session\TokenMismatchException;
+
+class CsrfFilter {
+
+	/**
+	 * Run the request filter.
+	 *
+	 * @param  \Illuminate\Routing\Route  $route
+	 * @param  \Illuminate\Http\Request  $request
+	 * @return void
+	 *
+	 * @throws \Illuminate\Session\TokenMismatchException
+	 */
+	public function filter(Route $route, Request $request)
+	{
+		if (Session::token() != $request->input('_token'))
+		{
+			throw new TokenMismatchException;
+		}
+	}
+
+}

app/Http/Filters/GuestFilter.php

@@ -0,0 +1,20 @@
+<?php namespace App\Http\Filters;
+
+use Auth, Redirect;
+
+class GuestFilter {
+
+	/**
+	 * Run the request filter.
+	 *
+	 * @return mixed
+	 */
+	public function filter()
+	{
+		if (Auth::check())
+		{
+			return Redirect::to('/');
+		}
+	}
+
+}

app/Http/Filters/MaintenanceFilter.php

@@ -0,0 +1,20 @@
+<?php namespace App\Http\Filters;
+
+use App, Response;
+
+class MaintenanceFilter {
+
+	/**
+	 * Run the request filter.
+	 *
+	 * @return mixed
+	 */
+	public function filter()
+	{
+		if (App::isDownForMaintenance())
+		{
+			return Response::make('Be right back!');
+		}
+	}
+
+}

app/Http/Requests/.gitkeep

@@ -0,0 +1,37 @@
+<?php
+
+/*
+|--------------------------------------------------------------------------
+| Application Routes
+|--------------------------------------------------------------------------
+|
+| Here is where you can register all of the routes for an application.
+| It's a breeze. Simply tell Laravel the URIs it should respond to
+| and give it the Closure to execute when that URI is requested.
+|
+*/
+
+/**
+ * Set the default documentation version...
+ */
+define('DEFAULT_VERSION', '4.2');
+
+/**
+ * Convert some text to Markdown...
+ */
+function markdown($text) {
+	return (new Parsedown)->text($text);
+}
+
+/**
+ * Root route...
+ */
+get('/', function() {
+	return view('index');
+});
+
+/**
+ * Documentation routes...
+ */
+get('docs', 'DocsController@showRootPage');
+get('docs/{version}/{page?}', 'DocsController@show');