super-powered-acf/readme.txt at main · Hackkzy/super-powered-acf · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
=== Super Powered ACF ===
Contributors: hackkzy404
Tags: acf, advanced custom fields, automation, ai field generator, super powered acf
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate ACF fields automatically with AI, saving time and effort when creating new field groups.

== Description ==
🚨 **IMPORTANT: This Plugin Requires a Google Gemini API Key**

🚀 **Super Powered ACF revolutionizes field creation in ACF!**

Instead of manually configuring fields, just **describe what you need**, and AI will generate ACF fields for you!

🔹 **Key Features:**
- **AI-powered field generation** – No manual setup
- **Describe your fields** – AI understands and generates them for you
- **Intelligent field type selection** – AI picks the best match
- **Works with both ACF Free & Pro**

== External Services ==
This plugin connects to Google's Gemini API to generate ACF fields based on user prompts.

- **What data is sent?** The user’s entered prompt is sent to the API to generate relevant fields.
- **When is data sent?** Only when the "Generate with AI" button is clicked.
- **Where is data sent?** Requests are sent to Google’s Gemini API endpoint.
- **Privacy Policy:** [Google Privacy Policy](https://policies.google.com/privacy)
- **Terms of Service:** [Google AI Terms](https://policies.google.com/terms)

No personal data, user credentials, or sensitive information is sent.

== Git Repository ==
Find the source code, report issues, and contribute at:
📌 [GitHub Repository](https://github.com/Hackkzy/super-powered-acf)

== Installation ==
⚠️ AI-powered field generation only works when creating a new field group. It does **NOT** work when editing existing field groups.

1. **Install via WordPress:**
	- Go to **Plugins → Add New**
	- Search for **Super Powered ACF**
	- Click **Install Now** and **Activate**

2. **Install via Upload:**
	- Download the latest version from [GitHub](https://github.com/Hackkzy/super-powered-acf)
	- Go to **Plugins → Add New → Upload Plugin**
	- Select the ZIP file and click **Install Now**
	- Activate the plugin

3. **Manual Installation:**
	- Upload the plugin files to `/wp-content/plugins/super-powered-acf/`
	- Go to **Plugins** and activate **Super Powered ACF**

4. **Ensure ACF is installed:**
	- This plugin requires **Advanced Custom Fields (ACF Free or Pro)**
	- If ACF is missing, install it from **Plugins → Add New**

5. **Set up your Gemini API Key (REQUIRED):**
	- Go to [Google AI Studio](https://aistudio.google.com) and log in.
	- Click **Get API Key** → Create **API Key**.
	- Copy the key and paste it into **Super Powered ACF Settings**.

6. **Start using AI-powered field generation:**
	- **Go to ACF → Field Groups → Add New**
	- Click "**Generate Fields with AI**" (This button will only show up when creating new field groups. Future updates may extend functionality.)
	- **Enter a prompt** (e.g., "Create a field group for real estate listings with property name, price, location, and image gallery.")
	- Review generated fields, adjust if needed, and save!🎉

== Frequently Asked Questions ==
= Does this work with existing field groups? =
No, AI-powered field generation is only available when creating new field groups. Future updates may extend functionality.

= Do I need Advanced Custom Fields Pro? =
No, this plugin works with both ACF Free and ACF Pro.

= How accurate is the AI-generated output? =
AI generates fields based on your description, but it's always recommended to review and adjust them as needed.

= How do I get a Gemini API Key? =
1. Visit [Google AI Studio's official site](https://aistudio.google.com) and log in with your Google account.
2. Click **Get API Key** → Create **API Key**.
3. Copy the key and paste it into **Super Powered ACF Settings**.

== Troubleshooting ==
- **AI button not showing?** Make sure **JavaScript** is not disabled in browser settings.
- **AI button not showing on an existing field group?** **This is expected!** AI-powered generation only works when creating a new field group.
- **Fields not generating?** Check your **Gemini API Key** in **Super Powered ACF settings**.
- **Still stuck?** Open an issue at [GitHub](https://github.com/Hackkzy/super-powered-acf/issues).

== Screenshots ==
1. **Set Up Gemini API Key** – Navigate to Super Powered ACF settings and enter your Gemini API key (Required).
2. **Navigate to ACF Field Groups** – Go to WordPress Dashboard → ACF → Field Groups → Click "Add New".
3. **Generate Fields** – Click "Generate Fields with AI" button. This button is only visible when creating a new field group.
4. **Enter a Prompt** – Type a description of your fields, and AI will generate them.
5. **Generated Fields Preview** – AI automatically generates fields based on your prompt; review and adjust before saving.

== Changelog ==
= 1.0.0 =
* Initial release