laravel.io
1.0.0
これは、Laravel.io コミュニティ ポータルのリポジトリです。コードは完全にオープンソースであり、MIT ライセンスに基づいてライセンスされています。皆様の貢献を歓迎しますが、問題を作成したりプル リクエストを送信したりする前に、貢献ガイドを読むことをお勧めします。マシン上でアプリのセットアップを開始するには、以下のインストール ガイドをお読みください。
私たちをスポンサーしてくださったこれらの素晴らしい企業に感謝したいと思います。スポンサーになることに興味がある場合は、Laravel.io GitHub スポンサー ページにアクセスしてください。
イベンティ
フォージ
使者
ファゾム
ティンカーウェル
ベアーズデヴ
N-iX
インストールを開始するには、次のツールが必要です。
PHP8.3
作曲家
故宮
係員付き係員
~/Sites/laravel.io場所は、マシン上の任意のディレクトリに自由に調整できることに注意してください。その際、必ず目的のディレクトリ内でvalet linkコマンドを実行してください。
git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.ioを使用してこのリポジトリのクローンを作成します
composer install実行して PHP の依存関係をインストールします。
laravelというローカルデータベースを設定します。
composer setup実行してアプリケーションをセットアップします
Mailtrap などの動作する電子メール ドライバーをセットアップする
valet link実行して、サイトをテスト用 Web アドレスにリンクします
テスト スイートを実行できるように、MySQL でtestingデータベースを作成します。
以下から（オプションの）機能を設定します
http://laravel.io.test にアクセスすると、ブラウザでアプリにアクセスできるようになります。データベースをシードした場合は、 testingとpasswordを使用してテスト アカウントにログインできます。
GitHub 認証をローカルで機能させるには、GitHub に新しい OAuth アプリケーションを登録する必要があります。ホームページ URL にはhttp://laravel.io.testを、コールバック URL にはhttp://laravel.io.test/auth/githubを使用します。アプリを作成したら、 .envファイルの以下の環境変数に ID とシークレットを入力します。これで、GitHub で認証できるようになりました。
GITHUB_ID= GITHUB_SECRET= GITHUB_URL=http://laravel.io.test/auth/github
Algolia 検索をローカルで実行するには、新しいアカウントに登録し、 threadsというインデックスを作成する必要があります。 Algolia には、開発環境に必要なすべての要件を満たす無料枠があります。次に、 .envファイル内の以下の変数を更新します。アプリ ID と秘密キーは、Algoila UI のAPI Keysセクションにあります。
SCOUT_DRIVER=algolia
SCOUT_QUEUE=true
ALGOLIA_APP_ID=
ALGOLIA_SECRET="Use the Write API Key"
VITE_ALGOLIA_APP_ID="${ALGOLIA_APP_ID}"
VITE_ALGOLIA_SECRET="Use the Search API Key"
VITE_ALGOLIA_THREADS_INDEX=threads
VITE_ALGOLIA_ARTICLES_INDEX=articles
VITE_ALGOLIA_USERS_INDEX=users既存のスレッドにインデックスを付けるには、次のコマンドを実行します。
php 職人スカウト:import AppModelsThread
新しいスレッドはインデックスに自動的に追加され、更新されたスレッドは自動的に同期されます。インデックスをフラッシュしてやり直す必要がある場合は、次のコマンドを実行できます。
php 職人スカウト:AppModelsThread をフラッシュする
公開された記事が X で自動的に共有されるようにするには、アプリを作成する必要があります。アプリが作成されたら、 .envファイル内の以下の変数を更新します。コンシューマのキーとシークレット、およびアクセス トークンとシークレットは、X 開発者 UI のKeys and tokensセクションにあります。
TWITTER_CONSUMER_KEY= TWITTER_CONSUMER_SECRET= TWITTER_ACCESS_TOKEN= TWITTER_ACCESS_SECRET=
Bluesky で同じことを行うには、ログインとパスワードを使用してアプリ キーを設定するだけです。
BLUESKY_USERNAME= BLUESKY_PASSWORD=
承認された記事は、承認のために送信された順序で共有されます。記事は 1 日に 2 回、UTC の 14:00 と 18:00 に共有されます。記事が一度共有されると、再度共有されることはありません。
Laravel.io は、Telegram を通じて新しく投稿された記事をメンテナーに通知できます。これを機能させるには、Telegram ボットを設定し、トークンを取得する必要があります。次に、新しい記事のメッセージを送信するチャネルを設定します。
TELEGRAM_BOT_TOKEN= TELEGRAM_CHANNEL=
記事の閲覧数を有効にするには、Fathom Analytics アカウントを登録し、サイトにインストールする必要があります。次に、 .envファイル内の以下の環境変数を更新する前に、API トークンを作成してサイト ID を見つける必要があります。
FATHOM_SITE_ID= FATHOM_TOKEN=
記事とユーザーのヘッダー画像がデータベースに同期されるようにするには、Unsplash からアクセス キーをセットアップする必要があります。 Unsplash アプリには実稼働アクセスが必要であることに注意してください。
UNSPLASH_ACCESS_KEY=
その後、Unsplash の写真 ID をhero_image_id列の記事行に追加し、sync コマンドを実行して画像の URL と作成者データを取得できます。
php 職人 lio:sync-article-images
| 指示 | 説明 |
|---|---|
vendor/bin/pest -p | 並列実行でテストを実行する |
php artisan migrate:fresh --seed | データベースをリセットする |
npm run dev | CSS ファイルと JS ファイルをビルドして変更を監視する |
Laravel.io ポータルは現在、Dries Vints と Joe Dixon によって保守されています。ご質問がある場合は、お気軽にこのリポジトリで問題を作成してください。
問題を作成したり、プル リクエストを送信したりする前に、コントリビュート ガイドをお読みください。
貢献したりディスカッションに参加したりする前に、当社の行動規範をお読みください。
セキュリティの脆弱性を報告する方法については、セキュリティ ポリシーをご覧ください。
MITライセンス。詳細については、ライセンス ファイルを参照してください。
