advanced-custom-fields
Last commit date
core
14 years ago
css
14 years ago
images
14 years ago
js
14 years ago
lang
14 years ago
acf.php
14 years ago
readme.txt
14 years ago
screenshot-1.png
14 years ago
screenshot-2.png
14 years ago
screenshot-3.png
14 years ago
screenshot-4.png
14 years ago
readme.txt
303 lines
| 1 | === Advanced Custom Fields === |
| 2 | Contributors: Elliot Condon |
| 3 | Donate link: https://www.paypal.com/au/cgi-bin/webscr?cmd=_flow&SESSION=-B2MHZ-ioHQb-z1o22AMmhjSI08rxFqQdljyfqVa1R-4QrbQWPNcfL37jYi&dispatch=5885d80a13c0db1f8e263663d3faee8d5fa8ff279e37c3d9d4e38bdbee0ede69 |
| 4 | Tags: custom, field, custom field, advanced, simple fields, magic fields, more fields, repeater, matrix, post, type, text, textarea, file, image, edit, admin |
| 5 | Requires at least: 3.0 |
| 6 | Tested up to: 3.3 |
| 7 | Stable tag: 3.3 |
| 8 | |
| 9 | Completely Customise your edit pages with an assortment of field types: Wysiwyg, Repeater, text, image, select, checkbox, page link, post object and more! Hide unwanted metaboxes and assign to any edit page! |
| 10 | |
| 11 | == Description == |
| 12 | |
| 13 | Advanced Custom Fields is the perfect solution for any wordpress website which needs more flexible data like other Content Management Systems. |
| 14 | |
| 15 | * Visually create your Fields |
| 16 | * Select from multiple input types (text, textarea, wysiwyg, image, file, page link, post object, relationship, select, checkbox, radio buttons, repeater, more to come) |
| 17 | * Assign your fields to multiple edit pages (specific ID's, post types, post slugs, parent ID's, template names) |
| 18 | * Add, Edit and reorder infinite rows to your fields |
| 19 | * Easily load data through a simple and friendly API |
| 20 | * Uses the native WordPress custom post type for ease of use and fast processing |
| 21 | * Now uses custom Database tables to improve speed, reliability and future development |
| 22 | |
| 23 | = Field Types = |
| 24 | * Text (type text, api returns text) |
| 25 | * Text Area (type text, api returns text with `<br />` tags) |
| 26 | * WYSIWYG (a wordpress wysiwyg editor, api returns html) |
| 27 | * Image (upload an image, api returns the url) |
| 28 | * File (upload a file, api returns the url) |
| 29 | * Select (drop down list of choices, api returns chosen item) |
| 30 | * Checkbox (tick for a list of choices, api returns array of choices) |
| 31 | * Page Link (select 1 or more page, post or custom post types, api returns the url) |
| 32 | * Post Object (select 1 or more page, post or custom post types, api returns post objects) |
| 33 | * Date Picker (jquery date picker, options for format, api returns string) |
| 34 | * True / False (tick box with message, api returns true or false) |
| 35 | * Repeater (ability to create repeatable blocks of fields!) |
| 36 | * Relationship (select and order post objects with a tidy interface) |
| 37 | * Color Picker (Farbtastic!) |
| 38 | |
| 39 | = Tested on = |
| 40 | * Mac Firefox :) |
| 41 | * Mac Safari :) |
| 42 | * Mac Chrome :) |
| 43 | * PC Firefox :) |
| 44 | * PC ie7 :S |
| 45 | |
| 46 | = Demonstration = |
| 47 | http://plugins.elliotcondon.com/advanced-custom-fields/demonstration/ |
| 48 | |
| 49 | = Documentation = |
| 50 | http://plugins.elliotcondon.com/advanced-custom-fields/documentation/ |
| 51 | |
| 52 | = Field Type Info = |
| 53 | http://plugins.elliotcondon.com/advanced-custom-fields/field-types/ |
| 54 | |
| 55 | = Website = |
| 56 | http://plugins.elliotcondon.com/advanced-custom-fields/ |
| 57 | |
| 58 | = Bug Submission and Forum Support = |
| 59 | http://support.plugins.elliotcondon.com/categories/advanced-custom-fields/ |
| 60 | |
| 61 | = Please Vote and Enjoy = |
| 62 | Your votes really make a difference! Thanks. |
| 63 | |
| 64 | |
| 65 | == Installation == |
| 66 | |
| 67 | 1. Upload 'advanced-custom-fields' to the '/wp-content/plugins/' directory |
| 68 | 2. Activate the plugin through the 'Plugins' menu in WordPress |
| 69 | 3. You may be prompted for a Database Upgrade. This is necessary for ACF to function. Please backup your database and click the Upgrade button |
| 70 | 3. Click on Settings -> Adv Custom Fields and create your first Custom Field Group! |
| 71 | 4. Your ACF field group will now appear on the page / post / template you specified in the field group's location rules! |
| 72 | 5. Read the documentation to display your data: |
| 73 | |
| 74 | |
| 75 | == Frequently Asked Questions == |
| 76 | |
| 77 | = Q. I can't see the "Select Image" button for my image field! = |
| 78 | A. For Image uploads to work, your post type must support "editor" |
| 79 | |
| 80 | = Q. I have a question = |
| 81 | A. Chances are, someone else has asked it. Check out the support forum at: |
| 82 | http://support.plugins.elliotcondon.com/categories/advanced-custom-fields/ |
| 83 | |
| 84 | |
| 85 | == Screenshots == |
| 86 | 1. Creating the Advanced Custom Fields |
| 87 | |
| 88 | 2. Adding the Custom Fields to a page and hiding the default meta boxes |
| 89 | |
| 90 | 3. The Page edit screen after creating the Advanced Custom Fields |
| 91 | |
| 92 | 4. Simple and intuitive API. Read the documentation at: http://plugins.elliotcondon.com/advanced-custom-fields/documentation/ |
| 93 | |
| 94 | |
| 95 | == Changelog == |
| 96 | |
| 97 | = 3.0.3 = |
| 98 | * New translation: French (thanks to Netactions) |
| 99 | * Support: added support for new wp3.3 editor |
| 100 | * Bug fix: fixed WYSIWYG editor localised errors |
| 101 | * Bug fix: removed trailing commas for ie7 |
| 102 | |
| 103 | = 3.0.2 = |
| 104 | * New Feature: Added Export tab to export a WP native .xml file |
| 105 | * New Option: Relationship / Post type - filter by taxonomy |
| 106 | * New Option: default values for checkbox, select and radio |
| 107 | * New Function: register_options_page - add custom options pages (Requires the option page addon) |
| 108 | * Bug fix: WYSIWYG + repeater button issues |
| 109 | * Bug fix: general house keeping |
| 110 | |
| 111 | = 3.0.1 = |
| 112 | * Bug Fix - repeater + wysiwyg delete / add duplicate id error |
| 113 | * Bug fix - repeater + file - add file not working |
| 114 | * Bug Fix - image / file no longer need the post type to support "editor" |
| 115 | * WYSIWYG - fixed broken upload images |
| 116 | * misc updates to accommodate the soon to be released "Flexible Field" |
| 117 | |
| 118 | = 3.0.0 = |
| 119 | * ACF doesn't use any custom tables anymore! All data is saved as post_meta! |
| 120 | * Faster and more stable across different servers |
| 121 | * Drag-able / order-able metaboxes |
| 122 | * Fields extend from a parent object! Now you can create you own field types! |
| 123 | * New location rule: Taxonomy |
| 124 | * New function: register_field($class, $url); |
| 125 | * New Field: Color Picker |
| 126 | * New Option: Text + Textarea formatting |
| 127 | * New Option: WYSIWYG Show / Hide media buttons, Full / Basic Toolbar buttons (Great for a basic wysiwyg inside a repeater for your clients) |
| 128 | * Lots of bug fixes |
| 129 | |
| 130 | = 2.1.4 = |
| 131 | * Fixed add image tinymce error for options Page WYSIWYG |
| 132 | * API: added new function: update_the_field($field_name, $value, $post_id) |
| 133 | * New field: Relationship field |
| 134 | * New Option for Relationship + Post Object: filter posts via meta_key and meta_value |
| 135 | * Added new option: Image preview size (thumb, medium, large, full) |
| 136 | * Fixed duplicate posts double value problem |
| 137 | * API update: get_field($repeater) will return an array of values in order, or false (like it used to!) |
| 138 | * Radio Button: added labels around values |
| 139 | * Post object + Page Link: select drop down is now hierarchal |
| 140 | * Input save errors fixed |
| 141 | * Add 'return_id' option to get_field / get_sub_field |
| 142 | * Many bug fixes |
| 143 | |
| 144 | = 2.1.3 = |
| 145 | * Fixed API returning true for repeater fields with no data |
| 146 | * Added get_fields back into the api! |
| 147 | * Fixed field type select from showing multiple repeater activation messages |
| 148 | |
| 149 | = 2.1.2 = |
| 150 | * Fixed repeater sortable bug on options page |
| 151 | * Fixed wysiwyg image insert on options page |
| 152 | * Fixed checkbox value error |
| 153 | * Tidied up javascript + wysiwyg functions |
| 154 | |
| 155 | |
| 156 | = 2.1.1 = |
| 157 | * Fixed Javascript bugs on edit pages |
| 158 | |
| 159 | = 2.1.0 = |
| 160 | * Integrate acf_values and wp_postmeta! Values are now saved as custom fields! |
| 161 | * Ajax load in fields + update fields when the page / post is modified |
| 162 | * API has been completely re written for better performance |
| 163 | * Default Value - text / textarea |
| 164 | * New upgrade database message / system |
| 165 | * Separate upgrade / activate scripts |
| 166 | * Select / page link / post object add Null option |
| 167 | * Integrate with Duplicate Posts plugin |
| 168 | * New location rule: post format |
| 169 | * Repeater field attach image to post |
| 170 | * Location: add children to drop down menu for page parent |
| 171 | * Update script replaces image urls with their id's |
| 172 | * All images / Files save as id's now, api formats the value back into a url |
| 173 | * Simple CSS + JS improvements |
| 174 | * New Field: Radio Buttons (please note Firefox has a current bug with jquery and radio buttons with the checked attribute) |
| 175 | |
| 176 | = 2.0.5 = |
| 177 | * New Feature: Import / Export |
| 178 | * Bug Fixed: Wysiwyg javascript conflicts |
| 179 | * Bug Fixed: Wysiwyg popups conflicting with the date picker field |
| 180 | * New style for the date picker field |
| 181 | |
| 182 | = 2.0.4 = |
| 183 | * New Addon: Options Page (available on the plugins store: http://plugins.elliotcondon.com/shop/) |
| 184 | * API: all functions now accept 'options' as a second parameter to target the options page |
| 185 | * API: the_field() now implodes array's and returns as a string separated by comma's |
| 186 | * Fixed Bug: Image upload should now work on post types without editor |
| 187 | * Fixed Bug: Location rule now returns true if page_template is set to 'Default' and a new page is created |
| 188 | * General Housekeeping |
| 189 | |
| 190 | = 2.0.3 = |
| 191 | * Added Option: Repeater Layout (Row / Table) |
| 192 | * Fixed bug: Now you can search for media in the image / file fields |
| 193 | * Added Option: Image field save format (image url / attachment id) |
| 194 | * Added Option: File field save format (file url / attachment id) |
| 195 | * Fixed bug: Location rules for post categories now work |
| 196 | * Added rule: Page parent |
| 197 | * Fixed bug: "what's new" button now shows the changelog |
| 198 | * included new css style to fit in with WordPress 3.2 |
| 199 | * minor JS improvements |
| 200 | |
| 201 | = 2.0.2 = |
| 202 | * Added new database table "acf_rules" |
| 203 | * Removed database table "ac_options" |
| 204 | * Updated location meta box to now allow for custom location queries |
| 205 | * Hid Activation Code from logged in users |
| 206 | * Fixed JS bugs with wp v3.2 beta 2 |
| 207 | * Added new option "Field group layout" - you can now wrap your fields in a metabox! |
| 208 | * General housekeeping |
| 209 | |
| 210 | = 2.0.1 = |
| 211 | * Added Field Option: Field Instructions |
| 212 | * Added Field Option: Is field searchable? (saves field value as a normal custom field so you can use the field against wp queries) |
| 213 | * Added Media Search / Pagination to Image / File thickbox |
| 214 | * Added Media Upload support to post types which do not have a Content Editor. |
| 215 | * Fixed "Select Image" / "Select File" text on thickbox buttons after upload |
| 216 | * Repeater field now returns null if no data was added |
| 217 | |
| 218 | = 2.0.0 = |
| 219 | * Completely re-designed the ACF edit page |
| 220 | * Added repeater field (unlocked through external purchase) |
| 221 | * Fixed minor js bugs |
| 222 | * Fixed PHP error handling |
| 223 | * Fixed problem with update script not running |
| 224 | * General js + css improvements |
| 225 | |
| 226 | = 1.1.4 = |
| 227 | * Fixed Image / File upload issues |
| 228 | * Location now supports category names |
| 229 | * Improved API - now it doesn't need any custom fields! |
| 230 | * Fixed table encoding issue |
| 231 | * Small CSS / Field changes to ACF edit screen |
| 232 | |
| 233 | |
| 234 | = 1.1.3 = |
| 235 | * Image Field now uses WP thickbox! |
| 236 | * File Field now uses WP thickbox! |
| 237 | * Page Link now supports multiple select |
| 238 | * All Text has been wrapped in the _e() / __() functions to support translations! |
| 239 | * Small bug fixes / housekeeping |
| 240 | * Added ACF_WP_Query API function |
| 241 | |
| 242 | = 1.1.2 = |
| 243 | * Fixed WYSIWYG API format issue |
| 244 | * Fixed Page Link API format issue |
| 245 | * Select / Checkbox can now contain a url in the value or label |
| 246 | * Can now unselect all user types form field options |
| 247 | * Updated value save / read functions |
| 248 | * Lots of small bug fixes |
| 249 | |
| 250 | = 1.1.1 = |
| 251 | * Fixed Slashes issue on edit screens for text based fields |
| 252 | |
| 253 | = 1.1.0 = |
| 254 | * Lots of Field Type Bug Fixes |
| 255 | * Now uses custom database tables to save and store data! |
| 256 | * Lots of tidying up |
| 257 | * New help button for location meta box |
| 258 | * Added $post_id parameter to API functions (so you can get fields from any post / page) |
| 259 | * Added support for key and value for select and checkbox field types |
| 260 | * Re wrote most of the core files due to new database tables |
| 261 | * Update script should copy across your old data to the new data system |
| 262 | * Added True / False Field Type |
| 263 | |
| 264 | = 1.0.5 = |
| 265 | * New Field Type: Post Object |
| 266 | * Added multiple select option to Select field type |
| 267 | |
| 268 | = 1.0.4 = |
| 269 | * Updated the location options. New Override Option! |
| 270 | * Fixed un ticking post type problem |
| 271 | * Added JS alert if field has no type |
| 272 | |
| 273 | = 1.0.3 = |
| 274 | * Heaps of js bug fixes |
| 275 | * API will now work with looped posts |
| 276 | * Date Picker returns the correct value |
| 277 | * Added Post type option to Page Link Field |
| 278 | * Fixed Image + File Uploads! |
| 279 | * Lots of tidying up! |
| 280 | |
| 281 | = 1.0.2 = |
| 282 | * Bug Fix: Stopped Field Options from loosing data |
| 283 | * Bug Fix: API will now work with looped posts |
| 284 | |
| 285 | = 1.0.1 = |
| 286 | * New Api Functions: get_fields(), get_field(), the_field() |
| 287 | * New Field Type: Date Picker |
| 288 | * New Field Type: File |
| 289 | * Bug Fixes |
| 290 | * You can now add multiple ACF's to an edit page |
| 291 | * Minor CSS + JS improvements |
| 292 | |
| 293 | = 1.0.0 = |
| 294 | * Advanced Custom Fields. |
| 295 | |
| 296 | |
| 297 | == Upgrade Notice == |
| 298 | |
| 299 | = 3.0.0 = |
| 300 | * Editor is broken in WordPress 3.3 |
| 301 | |
| 302 | = 2.1.4 = |
| 303 | * Adds post_id column back into acf_values |