Macki.info geliştiren: Macki.info

Macki.info добавя бърз пряк път с едно натискане от страниците с
обяви, които вече разглеждате в alo.bg и adamieva.info, към същата
обява в Macki.info — където можете да прочетете коментари от
потребители, анализи и да откриете подобни обяви.

Как работи

Разширението добавя два бутона:

• „Отвори в Macki.info“ (червен) — отваря нов раздел с търсене в
  Macki.info, попълнено с адреса на съответната обява.
• „Покажи статистика“ (бял, контурен) — изтегля кратка статистика
  от Macki.info за същата обява и я показва като три плочки точно под
  бутоните: брой коментари, общ брой снимки (на самата обява и на
  свързаните обяви) и брой свързани обяви, които Macki.info вече знае
  за тази обява.

Тези бутони се показват на две места:

• На страницата на конкретна обява — като малък панел директно под
  заглавието на обявата, с кратко описание и двата бутона в пълен
  размер.
• В списъците с обяви — като компактен ред (с по-ниски бутони) за
  всяка обява поотделно. Всеки ред сочи към своята обява, така че
  можете да я отворите в Macki.info или да видите статистиката ѝ, без
  първо да влизате в самата обява.

Заявката за статистика се изпраща само при натискане на бутона —
никакви данни не напускат браузъра при просто отваряне на страницата.

Къде се показват бутоните

Разширението е целенасочено ограничено до конкретни раздели на двата
сайта — не се появява на потребителски акаунти или други несвързани
страници:

• alo.bg — в категория Запознанства, Ескорт (категорията се
  разпознава от навигационните връзки на страницата; това е новото име
  на категорията, която преди беше „Компаньонки, Ескорт“). Бутоните се
  показват както на страницата на отделна обява, така и на всеки ред
  в списъците с обяви от тази категория. Поддържат се и страниците,
  заместващи изтрити обяви (например „Обява № N е била изтрита“) — в
  този случай Macki.info може да покаже архивирани коментари или
  подобни обяви.
• adamieva.info — на страницата на конкретна обява, чийто адрес
  съответства на /obiava-{id} (например /obiava-4872702/...), както
  и на всяка обява в списъците с резултати, търсене или по област.

На всички други страници на тези два сайта и на всички други сайтове
в интернет разширението остава напълно неактивно.

Какво получавате в Macki.info

Macki.info обединява и анализира обяви от
поддържаните български сайтове за обяви. Чрез отваряне на обява в
Macki.info можете:

• Да прочетете коментари и анализ за конкретната обява.
• Да разгледате подобни или свързани обяви, събрани от същите
  източници.
• Да използвате търсенето, за да намерите свързани обяви по телефонен
  номер, име или местоположение — обяви, които споменават същия човек
  или контакти.

Поверителност и обработка на данни

Разширението е създадено да работи тихо.

• Без аналитика и телеметрия от трети страни. Разширението не
  изпраща данни към никаква външна аналитична услуга и не проследява
  поведението ви между сайтове.
• Без четене на съдържанието на страницата. Разширението чете само
  адреси (URL) — адреса на текущата страница, а в списъците и връзките
  към обявите във всеки ред — и проверява за един специфичен етикет на
  категория в елемента с навигационните връзки. Не чете текста на
  обявата, контактите, снимките или каквото и да е друго съдържание.
• Без изпращане на данни преди да натиснете бутон. Никаква мрежова
  заявка не напуска браузъра ви, докато вие не натиснете един от
  двата бутона. Точно тогава и точно толкова:
• Натискане на червения бутон „Отвори в Macki.info“ отваря в нов
  раздел обикновена навигация към
  https://macki.info/search?q={адрес-на-обявата}&referer_from=extension-{браузър}.
  Параметърът referer_from показва на Macki.info, че кликът е
  дошъл през разширението, и в кой браузър (extension-chrome,
  extension-firefox или extension-safari). Разширението не
  добавя и не изпраща никакъв идентификатор — то не съхранява
  нищо. Нищо друго не се изпраща.
• Натискане на белия бутон „Покажи статистика“ изпраща една
  GET заявка към https://macki.info/api/stats?url={адрес-на-обявата}.
  Заявката се изпраща с credentials: 'omit', така че не се
  прикрепят бисквитки, токени или други идентификатори. Отговорът
  съдържа само три числа (коментари, снимки, свързани обяви), които
  разширението показва веднага под бутоните и веднага забравя.
• Без локално съхранение. Разширението не използва storage и не
  записва нищо в браузъра — нито идентификатор, нито настройки. Няма
  стойност, която да напусне браузъра, освен адреса на обявата при
  изрично натискане на бутон.
• Без отдалечен код. Иконата и целият JavaScript код са в пакета
  на самото разширение. Нищо не се изтегля по време на изпълнение.
  Заявката към /api/stats връща само JSON данни (числа), а не код за
  изпълнение.
• Без фонов скрипт. Разширението работи само като content script
  на двата поддържани домейна (alo.bg и adamieva.info); без фонов
  service worker.

Права, обяснени

Разширението иска само host достъп до поддържаните сайтове — никакви
API права:

• Достъп до сайтовете *://*.alo.bg/* и *://*.adamieva.info/* —
  за да може content script-ът да разпознае страниците с обяви на тези
  два сайта и да добави панела с двата бутона. Content script-ът се
  изпълнява само на тези два домейна.
• Достъп до сайта *://macki.info/* (вкл. поддомейни) — за да
  може бутонът „Покажи статистика“ да направи fetch заявка към
  публичното API на Macki.info (/api/stats?url=...) от страницата на
  източника без CORS preflight. На самия macki.info не се изпълнява
  content script — правото се ползва единствено за изходящи мрежови
  заявки.

Без storage, без tabs, без scripting, без <all_urls>, без activeTab. Ако
бъдеща версия има нужда от повече, тя ще бъде поискана като ново право,
със съответно описание в changes.md.

Съвместимост

Разширението използва Manifest V3 и работи на:

• Google Chrome 109+
• Браузъри, базирани на Chromium (Edge, Brave, Opera, Vivaldi)
• Mozilla Firefox 115+ (съвместимо с ESR)
• Safari 15.4+ (Web Extensions / MV3; изисква отделен Xcode wrapper за
  публикуване в App Store, но същият код се изпълнява в трите среди)

Език

Потребителският интерфейс на разширението (текстът на бутона и
описанието в инжектирания панел) е на български език, тъй като
двата поддържани сайта са на български.

Поддръжка и обратна връзка

Сигнали за проблеми, предложения за нови функции или съобщения за
неправилно активиране могат да бъдат изпратени чрез имейла за
поддръжка, посочен на страницата на разширението в магазина.