diff --git a/app/Http/Controllers/Api/Admin/AdminResourceController.php b/app/Http/Controllers/Api/Admin/AdminResourceController.php index cdc30c2..6092540 100644 --- a/app/Http/Controllers/Api/Admin/AdminResourceController.php +++ b/app/Http/Controllers/Api/Admin/AdminResourceController.php @@ -7,6 +7,7 @@ use App\Models\Blog\Category; use App\Models\Blog\Comment; use App\Models\Blog\Post; use App\Models\Blog\Tag; +use App\Models\NewsletterSubscription; use App\Models\Website\AboutMe; use App\Models\Website\Project; use App\Models\Website\ProjectCategory; @@ -28,6 +29,7 @@ class AdminResourceController extends Controller 'project-categories' => ProjectCategory::class, 'about-me' => AboutMe::class, 'comments' => Comment::class, + 'newsletter-subscriptions' => NewsletterSubscription::class, ]; /** diff --git a/app/Http/Controllers/Api/NewsletterSubscriptionController.php b/app/Http/Controllers/Api/NewsletterSubscriptionController.php new file mode 100644 index 0000000..50de55f --- /dev/null +++ b/app/Http/Controllers/Api/NewsletterSubscriptionController.php @@ -0,0 +1,70 @@ +validate([ + 'email' => ['nullable', 'email', 'max:255'], + 'mobile' => ['nullable', 'string', 'max:30'], + ]); + + $email = isset($validated['email']) ? trim($validated['email']) : null; + $mobile = isset($validated['mobile']) ? trim($validated['mobile']) : null; + + if ($email === null || $email === '') { + $email = null; + } + if ($mobile === null || $mobile === '') { + $mobile = null; + } + + if ($email === null && $mobile === null) { + return response()->json([ + 'message' => 'حداقل ایمیل یا شماره موبایل را وارد کنید.', + 'errors' => [ + 'email' => ['حداقل ایمیل یا شماره موبایل را وارد کنید.'], + ], + ], 422); + } + + if ($email !== null) { + $existing = NewsletterSubscription::where('email', $email)->first(); + + if ($existing !== null) { + return response()->json([ + 'message' => 'شما قبلاً در خبرنامه عضویت داشتهاید.', + 'subscribed' => true, + ]); + } + } + + $subscription = NewsletterSubscription::create([ + 'email' => $email, + 'mobile' => $mobile, + ]); + + return response()->json([ + 'message' => 'عضویت شما در خبرنامه با موفقیت ثبت شد.', + 'subscription' => $subscription, + ], 201); + } +} \ No newline at end of file diff --git a/app/Models/NewsletterSubscription.php b/app/Models/NewsletterSubscription.php new file mode 100644 index 0000000..007be4c --- /dev/null +++ b/app/Models/NewsletterSubscription.php @@ -0,0 +1,10 @@ +id(); + $table->string('email', 255)->nullable()->index(); + $table->string('mobile', 30)->nullable(); + $table->timestamps(); + }); + } + + public function down(): void + { + Schema::dropIfExists('newsletter_subscriptions'); + } +}; \ No newline at end of file diff --git a/routes/api.php b/routes/api.php index 3840aee..c61a234 100644 --- a/routes/api.php +++ b/routes/api.php @@ -10,6 +10,7 @@ use App\Http\Controllers\Api\Blog\PostController; use App\Http\Controllers\Api\Blog\PostInteractionController; use App\Http\Controllers\Api\Blog\TagController; use App\Http\Controllers\Api\ContactMessageController; +use App\Http\Controllers\Api\NewsletterSubscriptionController; use App\Http\Controllers\Api\Website\AboutMeController; use App\Http\Controllers\Api\Website\ProjectCategoryController; use App\Http\Controllers\Api\Website\ProjectController; @@ -84,6 +85,17 @@ Route::middleware('throttle:60,1')->group(function () { Route::post('contact', [ContactMessageController::class, 'store']) ->middleware('throttle:5,1'); +/* +|-------------------------------------------------------------------------- +| Newsletter subscriptions +|-------------------------------------------------------------------------- +| Stored and read from the admin panel like contact messages, so the write +| endpoint is public (no auth) but throttled the same way. +*/ + +Route::post('newsletter/subscribe', [NewsletterSubscriptionController::class, 'subscribe']) + ->middleware('throttle:5,1'); + /* |-------------------------------------------------------------------------- | Public blog interactions diff --git a/tests/Feature/NewsletterSubscriptionTest.php b/tests/Feature/NewsletterSubscriptionTest.php new file mode 100644 index 0000000..fba4c2b --- /dev/null +++ b/tests/Feature/NewsletterSubscriptionTest.php @@ -0,0 +1,97 @@ +postJson('/api/newsletter/subscribe', [ + 'email' => 'reader@example.com', + ]); + + $response->assertStatus(201); + + $this->assertDatabaseHas('newsletter_subscriptions', [ + 'email' => 'reader@example.com', + 'mobile' => null, + ]); + } + + public function test_mobile_only_subscription_is_accepted() + { + $response = $this->postJson('/api/newsletter/subscribe', [ + 'mobile' => '+989120001122', + ]); + + $response->assertStatus(201); + + $this->assertDatabaseHas('newsletter_subscriptions', [ + 'mobile' => '+989120001122', + ]); + } + + public function test_email_and_mobile_are_both_stored() + { + $response = $this->postJson('/api/newsletter/subscribe', [ + 'email' => 'reader@example.com', + 'mobile' => '+989120001122', + ]); + + $response->assertStatus(201); + + $this->assertDatabaseHas('newsletter_subscriptions', [ + 'email' => 'reader@example.com', + 'mobile' => '+989120001122', + ]); + } + + public function test_subscription_requires_email_or_mobile() + { + $this->postJson('/api/newsletter/subscribe', [])->assertStatus(422); + $this->postJson('/api/newsletter/subscribe', ['email' => ''])->assertStatus(422); + } + + public function test_invalid_email_is_rejected() + { + $this->postJson('/api/newsletter/subscribe', [ + 'email' => 'not-an-email', + ])->assertStatus(422); + } + + public function test_duplicate_email_is_idempotent() + { + NewsletterSubscription::create(['email' => 'reader@example.com']); + + $response = $this->postJson('/api/newsletter/subscribe', [ + 'email' => 'reader@example.com', + ]); + + $response->assertStatus(200); + + $this->assertDatabaseCount('newsletter_subscriptions', 1); + } + + public function test_admin_can_list_subscriptions() + { + $this->actingAsAdmin(); + NewsletterSubscription::create(['email' => 'a@example.com', 'mobile' => '+989120001122']); + NewsletterSubscription::create(['email' => 'b@example.com']); + + $this->getJson('/api/admin/resources/newsletter-subscriptions') + ->assertStatus(200) + ->assertJsonCount(2, 'data'); + } + + public function test_subscriptions_require_an_admin() + { + $this->getJson('/api/admin/resources/newsletter-subscriptions') + ->assertUnauthorized(); + } +} \ No newline at end of file