Reasons for Item Improvement

Zipping issues

  • Wrong archive structure. Please, refer to the rules and conditions of structuring a product archive in Seller Guide

Design issues

  • Issues caused by the readability of design elements. Some elements of your site’s design are difficult to read or feature poor contrast to other elements. Make sure that all blocks of your website make clever use of contrast, are easy to read, and feature smartly organized color schemes.
  • Typographic inconsistency. The theme’s typography should be polished. Make sure that content hierarchy is applied clearly on all pages and in all blocks of the design.
  • Wrong visual hierarchy. Make sure that the theme utilizes the common, logical principles to highlight essential design blocks and group the most significant elements.
  • Inconsistent use of tabs and spaces. Make sure that your work is formatted properly. Double check that there is clear logic in the way your design’s elements are organized into tabs and the way spaces are used.
  • Color scheme. The chosen color scheme should be polished.
  • Font choices. The choice of typography is of significant importance in the creation of a visual hierarchy of web designs. Make sure that the chosen fonts fit your work logically.

Code Quality Issues

  • Inline CSS is not permitted. Please, remove all the inline CSS.
  • CSS TABLE OF CONTENTS: Make sure the CSS file is well documented with proper table of contents. For more information, see: here.
  • CSS specificity. You need to enhance CSS specificity and avoid “!important”.
  • Use local files for all CSS and JS instead of CDN.
  • JavaScript files need to be placed at the bottom, barring critical exclusion. [Modernizr, for instance].
  • Code formatting. Make sure that the code is properly formatted and is easy to read.
  • INDENTATION & SPACE VS TABS: please make sure that your code is correctly indented and that it’s consistent with the use of spaces or tabs for indentation of the code. We do not give preference to any, but we need the author to pick one and use it for all the code.
  • WordPress:
    • Scripts and styles should not be hardcoded anywhere in your theme or added any other way but with wp_enqueue_* hook and should be added from the functions file. This includes custom JS/CSS. For inline styles see: here and for scripts here
    • You should avoid, and not hardcode, custom body_class(). Main reason for this is being able to remove the class when needed i.e. child themes. What you can do
    • Always use esc_url when sanitizing URLs, including WordPress related, also, all home_url() must include a trailing slash such as home_url(‘/‘) See: here.
    • wp_footer should be placed immediately before body closing tag.
    • Please, make sure your theme doesn’t raise any errors or warnings with theme-check.
    • The localization file should be in English and delivered as .POT file. .POT will contain all translation strings. .POT file name should match the themes-slug. Theme can include actual translation files, but it should not add the en_US.mo or en_US.po because English is already implied.
    • Please, use proper hooks to enqueue any scripts / styles i.e.:
      • wp_enqueue_scripts for frontend
      • login_enqueue_scripts for login screen
      • admin_enqueue_scripts for admin dashboard
    • These hooks should never be used to enqueue files:
      • admin_print_scripts
      • admin_print_styles
      • wp_print_styles
      • init
      • wp_head
      • wp_footer
    • Directory path should be get_template_directory() and not dirname( FILE ).
    • Please, make sure you properly prepare your data for $wpdb.
    • Data Validation issues have been found in your theme. All dynamic data must be correctly escaped for the context where it is rendered. – All dynamic data must be escaped with esc_attr() before rendered in an html attribute. – Whenever you are rendering a url to the screen its value must be passed through esc_url() first. – If dynamic data is rendered inside an attribute that triggers a JavaScript event, it must be escaped with esc_js().
    • Translate all strings within PHP variable and escape where needed. JS and TGMPA included (when/if used). You need to use a text domain to denote all text belonging to that theme. The text domain is a unique identifier, which makes sure WordPress can distinguish between all loaded translations. This increases portability and plays better with already existing WordPress tools. Any strings within a PHP variable require to be translated. Please, see: here.
    • Prefix everything and use unique (theme-name-based) consistent slugs. Additional prefix is acceptable for when the author is using a framework. Avoid using initials or abbreviations. Here’s a list of the most common things that should be prefixed: PHP function names, PHP class names, PHP global variables, Action/Filter hooks, Script handles, Style handles and Image size names.
    • Please, also read:

Quality and Functionality Issues

  • Documentation is either missing or needs further improvement. Provide users with detailed and easy-to-follow documentation, making it easier for the end user to work with your theme.
  • Titles of groups and layers in PSD files. In PSD files, all layers and groups should be properly named and organized in a logical order. Keep the end users in mind when working on the creation of PSD files.
  • All groups should be collapsed. Before saving PSD files, make sure that all groups of layers are collapsed.
  • Replacing images with placeholders. Replace all commercial images with placeholders, except for the cases where your license allows you to apply images to the end product or your images for free use. Please, see some free resources for images which you can use:
  • You have some bugs or some functional working not correct. Please be careful and check all functional of the theme before upload.
  • Mobile friendliness. Make sure that all design elements are stylized to be properly displayed on mobile devices.
  • WordPress:
    • Blog publications display. Test all blog publications and post formats with Theme Unit Test
    • Widget stylization. Double-check that all standard WordPress widgets are styled properly, and seamlessly perform in all widget areas and on all devices.
    • Child theme issues. Child theme doesn’t install or causes issues in the work of the parent theme.

Information and Demonstration Issues

  • Please make sure that all additional attributes which you set for Item is right and related with the item.
  • Your all written information in the description must be related to the item and be accurate. Please make sure that your item title is right and related to the theme. Also, all images of screenshots, main image and thumbnails must be related to the item.