View source for Path of Exile 2 Wiki:Troubleshooting known issues

Issues on this wiki that are known to the admins/sysops and possible solutions on how to fix it. Consider the talk page if you want something added.

==Templates/module issues specific to this wiki==

===Item===
The {{tlx|Item}} template uses the [[Path of Exile Wiki:Known issues#Cargo|Cargo]] database to store data so it can be queried and displayed in tables automatically.

====Items not showing up or is out of sync in lists, item tables and other places====
Can occur due to:
# caching issues
# invalid queries
# template errors

=====Fixing item caching issues=====
Please see [[Path of Exile Wiki:Known issues#Fixing caching issues]] - changes (if needed) should be applied to the item's main page and the page(s) not showing the items.

=====Fixing invalid queries=====
The general process here is to check whether your query uses the correct conditions. 

Some tips:
* Start by [[null edit]]ing the source page and the list page.
* If the query is performed by the template you're using and not by yourself, make sure to check the template's documentation first
* If an item isn't included in the query, but you think it should be check the item's page values. Adjust your query if needed or check for caching issues
* Adjust the query terms to be more broader or more precise
* If hitting query limits, consider creating a concept or simplifying the query
* You can also [[smw:Help:Querying for queries|query for queries]] on a page to troubleshoot/identify the problem

=====Fixing template errors=====
Template errors will prevent the templates from performing correctly. In some cases there are shown on purpose to avoid people using invalid data, but may also be caused by errors in the template itself.

If you can't fix the error right away, check the documentation of the template.

If the error appears in the code of the template itself and if you're unable to fix it , please create a new section on the template talk page and/or notify the template authors/wiki admins on their user pages.

==Mediawiki==

===Page is not added to transcluded categories from pages with <nowiki><includeonly></nowiki>===
The symptom is generally that the page shows the category correctly at the bottom, but is not actually added to it.

Solution:
* [[Null edit]] the page the category is transcluded to.

===Fixing caching issues===
Prior to attempt to fix caching issues, please note there are multiple caches deployed:
* Cache of your browser (i.e. client-side)
* Intermediate cache from Cloudflare
* Cache used by the Mediawiki software and addons

Client-side cache issues should require no action on the wiki. Consider clearing your browser's cache or using a different browser to verify it's not client-side.

Issues with the Cloudflare will fix themselves eventually; if you preview a page you will get the current version. If you perform a [[wikipedia:Wikipedia:Wikipedia:Purge#Null_edit|null edit]] and you still see a version different from the version you just saved, don't worry about it - you're seeing a cached version which will be eventually updated to the saved version.
Please note that if you have a gamepedia PRO subscription you'll see the live version of pages instead, bypassing the cloud flare cache.

Mediawiki and addon related caching issues can be generally resolved by [[wikipedia:Wikipedia:Wikipedia:Purge#Null_edit|null edit]] the affected pages. Please note you may need to null edit other pages if you're transcluding content from other pages or are fetching semantic values (from Semantic MediaWiki).
If the edits are still not being applied, consider doing a [[wikipedia:Help:Dummy_edit|dummy edit]].

==Extensions==

===Scribunto (Modules/Lua)===
The [[mw:Extension:Scribunto|Scribunto]] extension allows for embedding scripting languages in MediaWiki. Currently the only supported scripting language is [https://www.lua.org/ Lua]. For a reference manual see the [[mw:Extension:Scribunto/Lua reference manual|Lua reference manual]].

====mw.text.split is very slow====

Solution:
* If possible use <code>string.split</code> instead

===Cargo===
<section begin=cargo/>
[[mw:extension/cargo|Cargo]] is a type of database used to store interesting values in various items, mods, versions etc. as rows in [[Special:CargoTables|cargo tables]]. The syntax is very similar to MySQL or SQL because it uses MySQL at its core. 

====Missing rows====
Cargo sometimes misses pages when it repopulates the tables. [[Null edit]]ing each page works most of the time.

====Duplicate rows====
When updating pages cargo sometimes does not remove the old rows. So the old row values would still be there and show up in queries. Recreating data clears that but data recreation misses rows instead. <code>group by</code> helps clean up duplicates but there is no guarantee that you will get latest version.

====One template declares/attaches to multiple cargo tables====
Cargo tables can become quite large with a lot fields. Since multiple tables can be joined together and queried for it is more elegant to move the fields to other tables instead. The caveat is that the templates need to be split as well otherwise cargo bugs out. 1 template per cargo table. 

====Errors during previews====
Cargo doesn't handle incorrect cargo queries gracefully and sometimes throws major errors that forces you to go back a page. Copy the source before submitting/previewing so your work doesn't get lost.

====HOLDS doesn't work as expected====
Cargo bug. Instead of using HOLDS try, *__full instead. The lists then becomes a ordinary string and can be queried as such. 

Example: 
* Replace <code>skill_gems.gem_tags HOLDS "Aura"</code> with <code>skill_gems.gem_tags__full LIKE "%Aura%"</code>
* Use [https://dev.mysql.com/doc/refman/5.5/en/regexp.html regexp] for more advanced queries: <code>events.id__FULL REGEXP "(, {{!}}^)SSF Abyss(, {{!}}$)"</code>.
** The delimiter in this case is <code>, </code>
** Replace <code>|</code> with <code><nowiki>{{!}}</nowiki></code> in normal wikitext.

====Case sensitivity====
Cargo is case insensitive. Use BINARY instead. Read more [https://www.mediawiki.org/wiki/Extension:Cargo/Common_problems here]. 

====Recreation jobs are queued?====
It's possible to see if a cargo data recreation job is active. See this
[https://pathofexile.gamepedia.com/api.php?action=query&meta=siteinfo&siprop=statistics page]

====Number can't be used in #expr====
* #cargo_query returns integers/floats with thousand separator. Not surprisingly this will break most calculators. Wrap <code>CONCAT()</code> around the number field to remove thousand separators.
* #cargo_query sometimes returns the numbers with hidden characters as well. Use <code>no html</code> to remove those.<section end=cargo />

===Semantic Mediawiki===
The [https://www.semantic-mediawiki.org/wiki/Help:User_manual|Semantic Mediawiki] extension is a type of database that allows for setting data as page properties. It is no longer used on this wiki due to its scaling limitations. [[mw:extension/cargo|Cargo]] is used instead. <section begin=smw />

====Query depth====
There is a limit on how large and complex SMW queries can be; you can use <code>format=debug</code> to get an idea what is happening with the query.

Some ways to solve this problem:
* reduce the number of conditions in the query
* reduce the number of subqueries (i.e. <code><nowiki><q></q></nowiki></code>
* summarize common conditions into a [[smw:Help:Concepts|concept]]
* use a lua module for further iteration purposes

====Redirect pages may cause issues with properties====
Can occur due to:
* moving pages (with properties) and leaving a redirect
* editing redirect pages
* deleting pages that contain redirects

Solution (steps):
# validate the properties on the real page are set as they should
## if missing or incorrect properties are present, null-edit the page
## if this is still the case, do a minor edit on the page such as adding a space

====Text search not working properly====
Causes and solutions
# Text after [https://www.semantic-mediawiki.org/wiki/Help:Type_Text 40th] character is not searched
#* Try limiting your search to the first portion of the text
#* Use other means of searching (i.e. other properties)
#* When working on template make sure the characters intended for search are not too long
#* SMW queries can support [[smw:Full-text search|Full-text searches]] but this site does not have all the requirements for it.
# Text may include HTML/wikitext
#* In case of wiki links screwing search up consider searching for words only, e.x. <code>~Life*Leech</code>

====Properties or values were changed in a template but they don't show up in the properties====
Such changes generally take a while (up to several hours) to go though, esp. on templates that are used in many places.

Solutions:
* Just wait it out (preferred)
* perform null-edits (edit with no changes) on all pages using the template
<section end=smw />