Questions tagged [documentation]

The tag has no usage guidance.

Filter by
Sorted by
Tagged with
1 vote
1 answer
28 views

wordpress.com vs local install

Are the differences documented somewhere between the software wordpress.com uses and the wordpress you use to install locally ? I'm running into subtle differences that cause bugs when I develop ...
aaaaaa's user avatar
  • 131
1 vote
2 answers
84 views

Is there a script to collect all hooks and filters provided by a plugin?

As a plugin developer who wants to provide better documentations to my customers I'm also including a dev section inside my docs. This section should contain all provided hooks and filters by my ...
Johnny97's user avatar
  • 214
1 vote
0 answers
51 views

PHPStorm and CodeSniffer do not recognize WPCS [closed]

I'm trying to use Wordpress Coding Standards in my PHP Storm projects but I keep getting errors. What I already did: I put it in composer.json: "require": { "squizlabs/php_codesniffer&...
Lucas Bacciotti's user avatar
0 votes
0 answers
99 views

Is the default value of FORCE_SSL_ADMIN documented?

(Update. I rephrased the title since I understood better meanwhile what was going on.) Dealing with an attempt to understand HTTPS redirection, I ended up seeing with a massive grep -r '...
Amessihel's user avatar
  • 101
0 votes
1 answer
388 views

Callback hooked to post_updated firing on new posts as well

Context: I'm using a plugin that allows me to add author boxes throughout my site (Simple Author Box), while providing an easy way for any user to update their social media links and profile pictures. ...
Renato S. Bispo's user avatar
7 votes
2 answers
1k views

Is there a list / reference for all current native WordPress blocks?

I'm working on a theme that should style all native WordPress blocks via CSS, including potentially extending them with custom 'style' options in the block editor via JS. Does anyone know of a list or ...
Michelle's user avatar
  • 3,438
0 votes
1 answer
319 views

How to use embed_content hook?

From the document of embed_content: Prints additional content after the embed excerpt. But I don't know which content it will print. Does it take any arguments?
Star Light's user avatar
0 votes
2 answers
43 views

Is it possible to view WP documentation within the WordPress shell?

I'm having trouble navigating the WP documentation so forgive me if this is common knowledge. Is it possible to view the documentation of classes and methods from within the shell? That is, is there ...
user3574603's user avatar
0 votes
1 answer
220 views

Changing the the_author_posts_link() hover title

Is it possible to change the title="" attribute that Wordpress generates with the_author_posts_link() ? It is currently displaying 'Messages of [User]' as a hover title but I wish to change this to ...
Kevin M.'s user avatar
9 votes
2 answers
1k views

What's the difference between the capability remove_users and delete_users?

In the list of capabilities, I found there's both remove_users and delete_users. It's not clear to me what remove_users is supposed to do, the Codex documentation just says it was introduced in ...
reed's user avatar
  • 225
12 votes
2 answers
16k views

What are all the query parameters for getEntityRecords?

I'm working on a plugin that defined a custom block for the Gutenberg/Block Editor. The block shows a select box of posts. When you select one, I create HTML with some of the selected post's fields, ...
oelna's user avatar
  • 221
3 votes
1 answer
930 views

Gutenberg & Pre-formatted Templates: Core Block Attributes

The Gutenberg Handbook currently has a short entry for creating whole templates of blocks, e.g. used for Custom Post Types or just pre-formatting posts. https://wordpress.org/gutenberg/handbook/...
Playnary's user avatar
  • 315
0 votes
1 answer
256 views

Check class_exists before class definition / Doxygen problem

Currently when I create a class for my WordPress, I start the class with if ( ! class_exist( 'class_i_want_create' ) ) : .... class_definition .... endif; But now I want to create a ...
Carsten Schmitt's user avatar
2 votes
1 answer
33 views

When should I use @see tag in my inline doc for Functions & Class Methods?

The coding standards state to use @see for "Reference to a function, method, or class that is heavily-relied on within." Ok. But if I have a function, it always means that something uses it, ...
vladlu's user avatar
  • 38
5 votes
3 answers
715 views

Is there widely accepted phpDoc syntax for documenting which hook calls a function?

I keep all hooks in one file, and the functions are organized in their respective classes (different auto-loaded files). Looking for a standard way to document that a function's sole purpose is to be ...
Curtis's user avatar
  • 111
1 vote
0 answers
509 views

Documentation for adding a tinyMCE view for visual live preview of custom shortcode?

I'm trying to add a WYSIWYG visual representation for a custom shortcode into the tinyMCE editor but I can barely find any information on how to do that. Researching the last few days resulted in ...
Hans Horstensen's user avatar
0 votes
1 answer
74 views

Will php documentation conflict with wordpress documentation?

Hi I have a php script that makes liberal use of /* */ // my question is will that conflict with wordpress since the wordpress engine often reads variables inside those things? The reason ...
john doe's user avatar
1 vote
1 answer
3k views

Are the default entries for a user in wp_usermeta documented?

On a fresh vanilla install of wordpress users have default entries like nickename, first_name, last_name and so forth in wp_usermeta. I'm not sure if that changes often or at all but I can't seem to ...
Floutsch's user avatar
1 vote
0 answers
70 views

Plugin developer automated documentation

I have published a plugin which provides a nice extensibility. Now, I want to provide my users an automated PHP Documentation which describes the API Functions, Filters and Actions like this page here:...
Matthias Günter's user avatar
0 votes
2 answers
38 views

Smarter Document Management links between three Wordpress sites sought

I've built and manage two primary/junior school sites in the UK. They've recently come together under a Multi Academy Trust (MAT) and consequently, they now share a fair amount of common policies and ...
Dozza's user avatar
  • 41
1 vote
1 answer
55 views

How to incorporate Documentation into wordpress?

I am building a site, and I would like to have my documentation built into the site. For example if I use JSDoc to generate documentation for javascript, I get the auto generated files, I can just ...
brianxautumn's user avatar
9 votes
1 answer
498 views

Is the codex no longer actively maintained?

I generally Google when I need a quick reference for a Wordpress function, and generally it's a Codex post that comes up first (eg. https://codex.wordpress.org/Function_Reference/get_term when ...
Tim Malone's user avatar
  • 4,724
0 votes
1 answer
1k views

Private pdf files

I would like to give access some private pdf files to only logged in users. I have this in my htaccess: RewriteCond %{REQUEST_FILENAME} ^.*(pdf)$ RewriteCond %{HTTP_COOKIE} !^.*wordpress_logged_in.*$...
user1443216's user avatar
8 votes
1 answer
134 views

Is there a top-down documentation for WordPress?

This may sound like a silly question, but is there any technical top-down documentation that explains how WordPress works? There's a lot of "How to..." style documentation, i.e. explaining how to get ...
user686249's user avatar
0 votes
1 answer
36 views

Mutliple users editing single document in wordspress

My team is working on wordpress for documentation purpose. No I want to create a document with multiple chapters and different team members should edit different chapters. One chapter opened by one ...
Ayse's user avatar
  • 101
0 votes
0 answers
60 views

Adding list of Indexes in wordpress document

I have been exploring wordpress to use it for documentation puposes. I'm stuck at a point where I am unable to add a list of Indexes to the document. Can I add indexes to a wordpress document the way ...
Ayse's user avatar
  • 101
1 vote
1 answer
2k views

How to view WordPress' default category IDs?

It seems that Wordpress has default categories with default (and unchangeable) IDs. For example, the uncategorized category seems to always have an id of 1. Is this always the case? Is there any ...
Isaac Gregson's user avatar
0 votes
1 answer
34 views

Do define() statements need phpDocumentor-style docblocks?

There's no word on this in the WordPress Documentation Standards, but do define() statements need phpDocumentor-style docblocks? /** * Should this docblock be here? * * @since 1.0.0 */ define( '...
henrywright's user avatar
  • 3,037
1 vote
1 answer
1k views

Why does my <Style> dissappear?

Why does my style-tag disappear, in both my free site and my localhost site? Where do I find the Wordpress guidelines that specify what can-not be done. Example, where do I find: "Wordpress does not ...
apergiel's user avatar
5 votes
2 answers
742 views

How should I document function calls?

Reading the WordPress PHP Documentation Standards, I can't see anywhere that mentions how to document a function call such as add_action( 'foo', 'bar' ); Should I be documenting function calls and, ...
henrywright's user avatar
  • 3,037
0 votes
0 answers
75 views

Does a codex exist for creating meta boxes in taxonomy

I am looking for WordPress official documentation to create meta boxes in a taxonomy. There are many tutorials, but each of them is completely different. I don't want to use any plugins. I need the ...
user2506619's user avatar
7 votes
2 answers
6k views

Javascript WP Object Documentation?

I was working on implementing the media library within one of my plugins/themes. I found a nice tutorial (http://mikejolley.com/2012/12/using-the-new-wordpress-3-5-media-uploader-in-plugins/) that ...
Shane's user avatar
  • 173
2 votes
1 answer
118 views

How to submit documentation with plugin

When I submit a plugin to the wordpress public repo, how am I supposed to submit documentation? What is considered standard or good practice? Should I just have all documentation on the be page that ...
Thought Space Designs's user avatar
0 votes
2 answers
4k views

wp_nav_menu $theme_location parameter ignored

This is the first paragraph of the documentation of the function wp nav menu: Given a theme_location parameter, the function displays the menu assigned to that location, or nothing if no such ...
Philipp Zedler's user avatar
5 votes
1 answer
300 views

WordPress objects class reference

In WordPress we have several objects defined through classes that are enough documented. These are the WP_Query, WPDB, WP_Post and other. There are other objects however that are actually created at ...
Andrea Sciamanna's user avatar
-1 votes
4 answers
65 views

documentation on arguements?

I have seen many different parameters or arguments that can be passed to a query. For example, category_in, category_and term_id to name a few. Some of these can be found by using print_r to print out ...
Jamie's user avatar
  • 1,363
0 votes
1 answer
29 views

How indicate when a functions was upgraded in relationship to the entire program [closed]

for inline documentation there are those @somethings for some php documenter, when there is the common @since @version and so on. I have a lot of functions that are all part of a big package. But ...
amy's user avatar
  • 385
1 vote
2 answers
1k views

where is the documentation for add_action() parameters?

I am reading the source of a plugin (gallery to slideshow plugin) to make it behave like i want and it is using an action add_action( 'the_posts', array( &$this, 'have_gallery' ), 10, 1 ); I ...
Dr Deo's user avatar
  • 235
0 votes
1 answer
67 views

Knowledgebase / Docs: Custom Post Type, Pages or as a Post Category?

I'm trying to decide on how to organize a new site/theme. It has the standard sections: Home, About, Contact, Blog but also an (admin-only editable) Knowledgebase/Documentation area. My first ...
hhins's user avatar
  • 133
2 votes
3 answers
4k views

Wordpress plugin for authoring technical documentation? [closed]

We'd like to use WordPress to author the technical documentation for our software product. We've used plain-old WordPress pages, arranged then hierarchically, and it works ok, but it's not great. The ...
user237815's user avatar
2 votes
1 answer
130 views

Workflow and best practice for documentation [closed]

We have been creating a bunch of templates that are very custom and change from time to time but also have a bunch of similar parts from theme to theme. I am looking to streamline the way we create ...
jnolte's user avatar
  • 223
15 votes
1 answer
5k views

Alternative to query_posts for main loop? [duplicate]

Possible Duplicate: When to use WP_query(), query_posts() and pre_get_posts I just noticed today that the documentation for query_posts() mentions some "disadvantages" of using query_posts for ...
Tom Auger's user avatar
  • 7,036
2 votes
3 answers
348 views

Styling readme.html in plugin?

I am making readme.html file for a plugin with some detailed setup instruction that need to include screenshots. As rest of UI I want it be consistent with WordPress style and so I looked at its own ...
Rarst's user avatar
  • 99.6k
1 vote
2 answers
4k views

WordPress documentation - WP_Query arguments

I've been looking for a list all WP_Query arguments. This looks obvious, but http://codex.wordpress.org/Function_Reference/WP_Query isn't helpful at all, "post_type" is mentioned only in an example, ...
Wordpressor's user avatar
  • 5,041
0 votes
3 answers
126 views

Codex Version Focus on Production or Nightly?

The function get_users_of_blog() is to be deprecated in WP 3.1.0 but the current production release is 3.0.5. Does it make since to have the documentation reflect a nightly change when the ...
Workman's user avatar
  • 103
6 votes
2 answers
2k views

Where can I find a real architecture document on Wordpress?

I can only find some db schemas, what about all the rest of business logics in UML ?
user avatar
1 vote
2 answers
146 views

User Training Materials

Does anybody know of any good publicly-available Wordpress training materials (videos, manuals, etc.) that could be used to give content editors a basic overview of Wordpress. We have a a handful of ...
Kyle's user avatar
  • 113
5 votes
5 answers
2k views

WordPress training materials

Are there any good publicly-available WordPress training materials (videos, manuals, etc.) that could be used to give content editors a basic overview of WordPress? We have a handful of blogs on a ...
49 votes
8 answers
24k views

Local copy of WordPress Codex?

Sometimes I want to develop WordPress themes when I have no internet connection. I need the Function Reference and Template Tags to be productive. I searched for a downloadable or SVN copy of the ...
artlung's user avatar
  • 3,087