Code Insert Manager (Q2W3 Inc Manager)

This plugin was made to easily add html, css, php or javascript code to public WordPress pages.

Contents:

UPDATE FROM ver 1.x to 2.x NOTE:
Following page selectors have been removed: All Posts, All Pages, Category Pages and Tag Pages.
Inserts that used them will not work. But don’t worry, just recreate «Insert» and «Exclude» rules and they will work again!

Installation

  1. Check minimal system requirements: WordPress 2.8.0, PHP 5.1.0.
  2. Download plugin.
  3. Unzip and upload `q2w3-inc-manager` folder to the `/wp-content/plugins/` directory.
  4. Activate the plugin through the ‘Plugins’ menu in WordPress.

Uninstallation

  1. On the ‘Plugins’ menu in WordPress click ‘Deactivate’ plugin link.
  2. You will be redirected to the page with two options:
    • ‘Deactivate plugin’ — for simple plugin deactivation. Use it for temporary plugin deactivation if you plan to use plugin in future.
    • ‘Deactivate plugin and delete all settings from database’ — for complete plugin deactivation. All data associated with the plugin will be deleted from database.
Plugin deactivate options
Plugin deactivate options

Working with plugin
First of all go to the plugin setting page.
To begin creation of your Include click ‘Create new’ button. Include options window will appear.

Include options window
Include options window

Let’s see what are the meanings of all those options:

  • Description. A shot description of your code. Something like ‘My banner’ or ‘Google Analitics’.
  • Status. There are two options:
    • Active. Include code will be shown.
    • Disabled. Include code will not be shown.
  • Location. Here you can select area of the page where your code will appear. Possible locations are:
    1. Header (between <head></head> tags). Suitable for placing meta tags like Google Webmaster Tools ID, css or javascript code. Do not place here html code for visual output like <div>Hello</div>.
    2. Footer (bottom of the page). Suitable for placing any type of code. For expample this is a right place for Google Analitics code.
    3. Before page content (before WP loop). Suitable for any types of advertisement.
    4. After page content (after WP loop). Suitable for any types of advertisement.
    5. Before post content. Suitable for any types of advertisement.
    6. After post excerpt (since version 2.0.0).
    7. After post content. Suitable for any types of advertisement.
    8. Widget. Suitable for inserting advertisement blocks to the sidebar. Widget must be activated on the Appearance->Widgets page.
      • There is a sub option for Widget location — Widget title. This title is only for public pages. If no title provided, only widget include code will be displayed.
    9. Manual. This option allows you to place php function directly in your theme file.
    10. Shortcode. Insert code inside page or post content.

      Code Insert Locations
      Code Insert Locations
  • Priority. This field determines display order of the includes placed in the same location. Field value must be integer. Includes with equal priorities are sorted by creation time. Newer includes will be displayed after older. If you set priority to 0 or leave it empty, after saving include priority value will become equal to 100. This is done to create include with priority ‘always first’ and ‘always last’. To make include always first set priority to 1 and make sure that there are no other includes with this priority in the same location. To make include always last set priority higher than 100 (for example 1000). Now all new includes with undefined priority will be placed between ‘always first’ and ‘always last’.
  • Include on. Here you can select pages where your code CAN be shown. To select multiple pages or deselect page hold CTRL key. WordPress pages, posts pages, categories pages and tag pages can be selected one by one. Also there are several special page selectors:
    • All. That means all public pages.
    • Front page. Whether it is posts or a Page. Sub pages also belong to the front page. To exclude subpages select `Paged pages` in Exclude on section.
    • WP pages. These are WordPress Pages, not any generic webpage from your blog.
    • Posts pages. All post pages.
    • Date pages. These are all date-based archive pages (i.e. a monthly, yearly, daily or time-based archive).
    • Category pages. All Category archive pages.
    • Tag pages. All Tag archive pages.
    • Author pages. All author pages.
    • Attachment pages. All attachment pages.
    • Paged pages. All pages being displayed as «paged». This refers to an archive or the main page being split up over several pages. Only second and subsequent pages are considered «paged». This does not refer to a Post or Page whose content has been divided into pages using the nextpage QuickTag.
    • Search page. Any search result page.
    • Preview page. Single post page displayed in Draft mode.
    • Page 404. Paged displayed when ‘HTTP 404 Page not found’ error happens.
  • Exclude on. Here you can select pages where your code CANNOT be shown. Multiple select can be done by holding CTRL key.
  • Hide from admin. Since version 2.0 this option upgraded to Hide from user. Now you can specify user groups to hide code from.
  • Code. Html, css or javascript code. Inclusion of PHP code supported since version 1.1.0. PHP code must begins with `php open tag` (<?php). Examples:
<?php /* php open tag is required */ echo 'WP variable: '; print_r($GLOBALS['wp']); /* php close tag is not required */

 

<h1>Hello!</h1><?php echo 'PHP!' ?><h2>Bye!</h2>
  • Sub option Align (since version 1.1.0). Allows you to set horizontal align of the included code. Useful for aligning Google AdSense blocks.

A few words about settings page interface.
You can select table columns which will be displayed and can change number of table rows per page. To do this go to Screen options menu.

Screen options
Screen options

Also if Include options window is taking to much place you can minimize it by clicking on the window top bar (see screen shot above).

Frequently Asked Questions

  1. How many Includes may I create?

    The number of Includes is unlimited.

  2. What is ‘Widget title’ option?

    This option allows you to specify widget title for public WordPress pages. It will be displayed like Categories or Tags widget titles.
    If you leave this option blanc, widget will be displayed without title.

  3. I have set priority to 0 or left it blanc, but after saving it equals 100. Why?

    This is done to help you create Include with priority ‘always first’ and ‘always last’. To make Include always first set priority to 1 and make sure that there are no other includes with this priority in the same location. To make include always last set priority higher than 100 (for example 1000). Now all new includes with undefined priority will be placed between ‘always first’ and ‘always last’.

  4. Why Widget and Manual Includes priority is always 100 and I can’t change it?

    Widget and Manual Includes don’t use priority number for sorting. Don’t worry about it.

  5. In wich order sorted Includes with equal priorities?

    Equal priority Includes are sorted by creation time. Newer includes will be displayed after older.

Changelog

  • 2.3.0
    Added ability to insert shortcodes in comments. Option must be enabled in Code Insert Manager -> Settings page
  • 2.2.0
    Added support for Custom Post Type Archive pages
    Fixed small bug with Opera multiple select
  • 2.1.2
    Fixed conflict with Find and replace plugin (Guys, why are you creating new user instance each time?!?).
  • 2.1.1
    Added German translation
  • 2.1.0
    Post Formats are now available for page filters
    To admin page added search form and capability to filter table by status (Active/Disabled)
  • 2.0.1
    Plugin renamed to Code Insert Manager
    Added support for custom post types (support for each post type must be enabled on plugin settings page)
    Added support for custom taxonomies (support for each taxonomy must be enabled on plugin settings page)
    Added new insert location — After post excerpt
    Hide from admin option is upgraded to Hide from user
    Admin menu entry moved to top level
  • 1.3.1
    Added French translation.
  • 1.3.0
    Added new location — shortcode
  • 1.2.4
    Fixed php evaluation error in Manual include mode
    Plugin was successfully tested in WordPress 3.0
  • 1.2.3
    Improved page detection on themes with modified loop.
  • 1.2.2
    Fixed high memory usage on blogs with large number of posts/categories (more than 1000)
  • 1.2.1
    Fixed broken links (in plugin settings page) when WordPress installed in a subdirectory.
  • 1.2.0
    Fixed errors in WordPress MU.
  • 1.1.0
    New. Includes with PHP code now supported.
    New. Align option added.
  • 1.0.1
    Fixed ‘Create New’ button malfunction in Opera and Firefox.
    Fixed ‘Parse error: syntax error, unexpected T_PROTECTED in /htdocs/wp-content/plugins/q2w3-inc-manager/q2w3-table/q2w3_table.php on line 736’.
  • 1.0
    First public release.

Other Q2W3 plugins:

161 ответ к “Code Insert Manager (Q2W3 Inc Manager)”

Hi Q2w3 Inc Manger Plugin Admin.
YOur plugin is very nice and user friendly.. in start plugin running successfully but now when use this plugin and include pages the pop up screen is come out blank there is no any pages title shows.. i dont know why.. plz help me.. i update this plugin … but not any solution for this problem.

Hello!

Try the following:
1. Go to plugin page and find link that shows popup window for pages selection ([…]).
2. Right click on it and select «Copy link address» option or something like this (depends on your browser).
4. Open new browser tab (not new window) and open there copied link.
5. Did you see list of pages? If no, open wp-config.php file in the root of your WP installation and add this code — define(‘WP_DEBUG’, true); (place it after WPLANG constant) . Save wp-config and reload the page. Now you should see errors. Copy all output and send to me.
6. Remove define(‘WP_DEBUG’, true); from wp-config. I do not recommend to make this test on a production site. It will be unavailable during WP_DEBUG on.

probably have something like that in htaccess
# RewriteCond %{REQUEST_METHOD} =POST
# RewriteCond %{HTTP:Content-Type} !^(application/x-www-form-urlencoded|multipart/form-data.*(boundary.*)?)$ [NC]
# RewriteCond %{REQUEST_URI} !^/(wp-login.php|wp-admin/|wp-content/plugins/|wp-includes/).* [NC]
# RewriteRule .* — [F,NS,L]
could break the plugin

Thanks for the greate plugin. Just one thing disappointed, it doesn’t work with wordpress shortcode. So I can’t use it at this moment.

Hi Max,
I spent a whole and finally found a work around solution. Actaully, I can use :
<?php echo do_shortcode('[shortcode option1="value1" option2="value2"]'); ?>
Just replace [shortcode option1="value1" option2="value2"] with your shortcode, it will work !

Now I understood what are you talking about )
You have found the best way to execute shortcode inside include.

But I thought, you need to place include with help of shortcode inside post or page! Just to create new kind of location — SHORTCODE. Heh )))

Is it possible to get and include in between the «header» and the «before page content» ?
There is no option for this on the drop down provided and it is what I need. Whatever I place goes on the actual head tag (great for meta tags)or into just above this :

Thanks for writing back Max! Great Plugin !
The trouble is that I need to add a different scroller on each page, I guess I will make an include and work some php to handle this.
Cheers!

Hi Max,
I’m going nuts and no way I can make this simple test work.
I create a new
status=active; location manual; include on front page
inlude code :
[My HTML test]
[]

I place this in several locations on the template header and can only see the HTML but not the PHP, is it something I need to activate on Apache/php?
On viewing the source code the php is there but it is not read by the browser. I’m i going stupid?

I have this running Ok on several sites, very very useful, thanks.

Just uploaded to 2.8.3 in a sub directory and although the plug in loaded OK when I open the Include on link the Pages popup is blank.

Any suggestions?

Thanks

I just installed the plug in on another blog in the root of a domain but on the same server and I get the same problem.

Is the pop up script using ajax or something that needs a current install on the server?

Plugin uses thickbox library for popups. This library is supplied with WordPress.
What happend with other popups windows in wp-admin (for expample insert image to the post window), are they working properly?

Try to open this link in a browser (login to wp-admin and then open a new window in a browser). If you’ll see list of pages — link is ok, if you’ll see ‘page not found’ — problem in a link.

Try to do the following:
1. Log in to wp-admin
2. Copy ‘Include on’ link
3. Open a new tab in the same browser window
4. Open copied link in this new tab

I think you’ll see some kind of error.
If you’ll see blanc page again, look at web-server error log file for any php errors related to the time when you tried to open this link.

I noticed the problem when I posted here. During install it put /wordpress/wordpress/ in all its internal links so everything results in 404 error. My blog runs from / and all files other than index.php are in /wordpress/
Until till problem is resolved can’t use program. Too bad. Looked good. Let me know when problem fixed. Thx

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *


Срок проверки reCAPTCHA истек. Перезагрузите страницу.