# magick_ad

**Repository Path**: gitgreat/magick_ad

## Basic Information

- **Project Name**: magick_ad
- **Description**: 用于WordPress 平台的广告插件，可设置全局广告，单独的文章、页面、分类、标签广告，支持多种广告类型，还有弹窗广告，两侧悬浮广告、底部广告等
- **Primary Language**: JavaScript
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2023-07-15
- **Last Updated**: 2025-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: WordPress

## README

# 介绍

用于 WordPress 平台的广告插件，可设置全局广告，单独的文章、页面、分类、标签广告，支持多种广告类型，还有弹窗广告，两侧悬浮广告、底部广告等

- 设置框架：使用 ACF Pro 来进行选项设置

- 参考：https://wwads.cn/secret/

- 前台广告 ：使用 Vue 技术来撰写前台广告

- 后台数据展示：使用 Vue 技术来撰写后台数据展示功能

## 建议

- 单个页面的广告建议控制在 3 至 4 个以内
- 参考 Insert Post Ads 在文章下载部分添加广告

## 开发

magick_ad.php 去除 121 行注释
展示所有数据信息
includes/class-magick_ad-develop.php

## 发布

magick_ad.php 去除 123 行和 125 行注释

此版为开发版插件，如需正常使用还行对 css 资源和 js 资源打包处理。

## 修改文件

- 删除 vite 文件夹
- 去除 magick_ad.php 文件末尾的两个文件注释
- 添加 magick_ad.php 的 `run_magick_ad_develop();`函数

## 打包

对 vite 内的两个项目进行打包

# 待安排

- （考虑）添加单栏两图广告功能
- （考虑）添加单栏三图广告功能
- 确保给文章末尾添加广告一定是最后的
- 重写前端广告传值判断逻辑（一天的数据记录一条）
- 指定分类或标签下的广告可排除指定文章
- 添加悬浮侧栏广告：https://7b2.com/circle/63422.html
-  1、全部搜索结果列表页每页前两个都是广告  2、指定搜索结果页第2页第3篇后增加广告  3、根据搜索关键词增加广告

已放弃

- 给图片广告添加缩放效果（多余）
- 文章发布 24 小时后的文章显示广告 - https://www.npc.ink/7994.html（多余）

# 更新记录

## 2023

**1107**

- 全部广告和指定广告添加时间限制

**1106（v1.0.7）**

- 解决随机广告报错问题

**0722**

- 优化代码逻辑，便于维护
- 添加给指定分类下、标签下的文章添加广告功能

**0721**

- 将文字广告水印改为图片水印，解决移动端水印过大问题

**0712**

- 图片广告配置，强制填写距离的像素值

**0609**

- 添加指定分类广告
- 添加指定标签广告

**0525**

- 删除插件创建的数据库功能
- 在所有操作开始前检查 acf 是否安装
- 将两个菜单放一起，魔法广告和魔法混合
- 给广告添加上下左右四个边距选项
- 弹窗图层改为最高
- 将时间从小时改为天
- 给前台的 js，添加 lost 是否存在判断，

# bug

TGM 部分翻译有问题，需处理

必装插件和推荐插件
表格版本号

## B2 主题

评论列表上方 不正常显示
评论框 上方 下方 不正常

目前添加的方法是通过 WordPress 提供的钩子实现的，B2 主题没有使用相关钩子，导致相关功能不生效，我再想想办法
选择全站广告 ，文章前或者文章后 ，除了文章页面，其他页面都会出现个问题，右侧边栏重复出现广告位文章前和文章后广告，都在左上角


## 广告位置


0 : 默认
1 : 文章内容顶部
2 : 文章内容底部
3 : 文章内容第三段
4 : 全站顶部
5 : 全站底部
6 : 仅首页顶部
7 : 仅首页底部
8 : 仅文章页顶部
9 : 仅文章页底部
10 : 仅分类页顶部
11 : 仅分类页底部
12 : 仅标签页顶部
13 : 仅标签页底部
14 : 仅单页顶部
15 : 仅单页底部
16 : 仅搜索结果页顶部
17 : 仅搜索结果页底部
18 : 仅404页顶部
19 : 仅404页底部
20 : 仅作者页顶部
21 : 仅作者页底部