Merge pull request #488 from PlaceholderAPI/change/improve-wiki-faq

Improve Wiki FAQ

wiki/FAQ.md

@@ -1,16 +1,30 @@
+[readme]: https://github.com/PlaceholderAPI/PlaceholderAPI/blob/docs/wiki/wiki/README.md
+
 Here are frequently asked questions about stuff related to PlaceholderAPI.
 
-## It only shows %placeholder% and not the variable
-Make sure, that you've tried the following steps:
-- PlaceholderAPI is installed and running (Shows green in `/pl` and responds to the `/papi` command)
-- You downloaded the expansion with `/papi ecloud download [expansion]`  
-A list of available expansions and their placeholders can be found [[here|Placeholders]]!  
-Also note that not all placeholders are in a seperate expansion. Some are "hardcoded" into a plugin.
-- You reloaded PlaceholderAPI with `/papi reload` after downloading an expansion.
-- Any possible dependency for the expansion (Plugin) is installed and running.
-- The placeholder doesn't contain any typos.
-- The plugin that should use the placeholder actually supports PlaceholderAPI.
-For a list of plugins supporting PlaceholderAPI go [[here|Plugins-using-PlaceholderAPI]].
+## It only shows `%placeholder%` and not the variable
+When a plugin or `/papi parse me %placeholder%` only returns the placeholder itself and no value should you check for the following things:
+
+### The expansion is actually installed.
+In many cases is the cause that the expansion of the placeholder is missing.  
+Just execute `/papi ecloud download <name of expansion>` followed by `/papi reload` to activate it. You can find a list of Expansions and their Placeholders [[on this page|Placeholders]].
+
+**NOTE!**  
+Not all placeholders come in their own expansion. Some plugins *hardcode* them in and load them on startup, when hooking into PlaceholderAPI.
+
+### Plugin actualls supports PlaceholderAPI
+It can happen that the plugin you use to display the placeholder in doesn't support PlaceholderAPI. In such a case check, if the parse command returns the actual value of a placeholder.  
+If that is the case while the plugin is still displaying the placeholder, can this be an indicator of the plugin not supporting PlaceholderAPI.
+
+You can find a list of plugins supporting PlaceholderAPI [[here|Plugins-using-PlaceholderAPI]].  
+Just make sure that "Supports placeholders" has a check mark in front of it.
+
+### No typo in the placeholder
+Double-check that the placeholder you set doesn't contain a typo. You can use `/papi ecloud placeholders <expansion>` (replace `<expansion>` with the name of the expansion) to get a list of all the placeholders the expansion may have.  
+Keep in mind that this only works for separate expansions on the eCloud and not for those that are loaded by plugins.
+
+### Plugin is enabled
+If an expansion depends on a plugin, make sure you have the plugin installed and that it is enabled (Shows green in `/pl`).
 
 ## I can't download the expansion
 Make sure, that the connection to the cloud (https://api.extendedclip.com) isn't blocked by a firewall or similar.  
@@ -19,4 +33,8 @@ Next step would be to check if the expansion actually exists on the cloud. Not a
 If both checks failed, go to the cloud-page and download the jar manually. Put it then in the `expansions` folder of PlaceholderAPI (`/plugins/PlaceholderAPI/expansions`)
 
 ## How can other plugins use my placeholders with PlaceholderAPI?
-A tutorial can be found [[here|Hook into PlaceholderAPI]]!
+A tutorial can be found [[here|Hook into PlaceholderAPI]]!
+
+## Can I help on this wiki?
+You sure can!  
+We welcome contributions to our wiki by everyone. If you found a typo or want to improve this wiki in another way, head over to the [Wiki's readme file][readme] to find out about how you can contribute towards this wiki.