From 5d62158b1baa0d872fc8589e45a003d208166817 Mon Sep 17 00:00:00 2001
From: zuevav <34027267+zuevav@users.noreply.github.com>
Date: Thu, 30 Apr 2026 15:53:14 +0300
Subject: [PATCH] Improve VK photo-upload error message and token instructions

- Replace the misleading 'community token cannot upload photos' fallback warning with the actual VK error and a concrete checklist (photos right + token bound to the same group)
- Extend UI hint with troubleshooting note for the 'photos as links' symptom

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 classes/VKAPI.php | 5 ++++-
 index.php         | 3 +++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/classes/VKAPI.php b/classes/VKAPI.php
index d6959a2..38ecfe8 100644
--- a/classes/VKAPI.php
+++ b/classes/VKAPI.php
@@ -292,7 +292,10 @@ class VKAPI
 
             try {
                 $result = $this->wallPost($numericGroupId, $messageWithPhotos, []);
-                $result['warning'] = 'Фото добавлены как ссылки. Community-токен не поддерживает загрузку фото - нужен пользовательский токен.';
+                $firstError = $uploadErrors[0] ?? 'неизвестная ошибка';
+                $result['warning'] = 'Фото добавлены как ссылки — VK отказал в загрузке (' . $firstError . '). '
+                    . 'Проверьте, что ключ сообщества создан с правом «Фотографии» и принадлежит ИМЕННО той группе, в которую вы постите. '
+                    . 'Если используете пользовательский токен — у него должны быть права wall, photos, groups.';
                 return $result;
             } catch (Exception $e) {
                 throw new RuntimeException('Ошибка постинга: ' . $e->getMessage() . '. Также нет прав на загрузку фото.');
diff --git a/index.php b/index.php
index f1b8803..b53dfd0 100644
--- a/index.php
+++ b/index.php
@@ -635,6 +635,9 @@ foreach ($channels as $ch) {
                             <p style="font-size: 0.85em; color: var(--text-secondary); margin-top: 10px;">
                                 <strong>Важно:</strong> ключ сообщества бессрочный и не блокируется VK. Он постит и грузит фото только в свою группу — для нескольких групп создайте отдельный ключ в каждой.
                             </p>
+                            <p style="font-size: 0.85em; color: var(--text-secondary); margin-top: 8px;">
+                                <strong>Если фото уходят как ссылки</strong> (предупреждение в архиве) — значит у ключа нет права <strong>Фотографии</strong>, или ключ создан в другой группе. Удалите ключ и создайте заново в той же группе, в которую постите, отметив права: Управление, Стена, Фотографии, Сообщения сообщества.
+                            </p>
                             <p style="font-size: 0.8em; color: var(--text-secondary); margin-top: 8px;">
                                 Старый способ через <a href="https://vkhost.github.io/" target="_blank">vkhost.github.io</a> / VK Admin сейчас не работает — VK заблокировал это приложение (ошибка <code>[8] Application is blocked</code>).
                             </p>