Superglobals Plus

From the included readme:

Superglobals Plus is a developers tool that makes evaluating variables easy. It produces a clear overview of the contents of strings, arrays, constants, objects, arrays within object, objects within arrays or whatever...

Features:

• Show all GLOBALS, or just the Superglobals you need to evaluate.

• Show all defined constants (v1.2).

• Show a list of included files (v1.22).

• Optionally hide HTTP_ variables when showing all globals.

• Show the whole content of each variable, including all objects and arrays etc!

• Recursion protection (optional: recursion level/off)

• Show the variable type (array, string, object, integer, NULL, boolean, resource).

• Converts strings into their htmlentities before output (v1.0)

• Clear output (see included superglobals.png).

• Easy install on Zen Cart (1.3.x instructions included).

• Easy install on most (other) PHP scripts (no instructions included).

• Optional IP address protection.

• Admin switches for all options.

Attached screenshot of an example output to this post (or actually a small part of a screenshot).

Thanks paulm, will be handy.

Download (version 1.24):
http://www.zen-cart.com/index.php?main_page=product_contrib_info&products_id=747

The main difference with 1.23 is that the amount of information is less overwhelming after a fresh install, only $_POST and $_SESSION are shown now (of course it's very easy to switch on the other features again whenever needed).

Screenshot (the jpg attachment above was very unclear):

Paul, I finally got around to installing your superglobabls script. It's a great bit of work, just what ever ZC coder needs. Thanks a lot for putting this together.

B

By the way if anyone else gets a bit confused like me, you need to copy the CONTENTS of catalogue to the zencart root, not the whole folder.

Yeah, this will come in handy when I re-write the return authorization mod in the next few days.

yellow1912:

Yeah, this will come in handy when I re-write the return authorization mod in the next few days.

Does this mean I can stop providing support for the mod?

Not until I finish it :p

yellow1912:

Not until I finish it :p

Then I assume that after your version is posted in the downloads, you will assume the responsibility for support.

You sound very happy somehow :p

Yah, I can provide support for those who use the new versions.

yellow1912:

You sound very happy somehow :pNot sure about that, but I am very happy to hear that this mod helps others :smile:

And usually I am also happy when someone makes improvements to a mod I have worked on. It has not happened very often that somebody jumps in, but the times it did happen I have learned a lot from! I find it always very interesting to see how others solve issues I have worked on, and it often inspires me to work on it some more and make other improvements.

Paulm, we were talking about the Return Auth mod, not this one :D

yellow1912:

Paulm, we were talking about the Return Auth mod, not this one :DI know (but reading back, I agree it probably looks like I misunderstood)

paulm, thank you for this excellent tool! I have installed it and it is already helping me learn more about Zen Cart. It works with version 1.3.8.

I would like to suggest some improvement to the readme.txt in the package available for download. I believe that it is slightly clearer and may actually eliminate the need for the second readme.txt in extras subdirectory.

Here goes (only for the Zen Cart catalog section - I haven't tried the admin yet)...

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Installation (Zen Cart catalog):
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

1. Backup your files and the database (as always).

2. Copy the contents of the superglobals.sql file into the textbox of the sql patch tool in the Zen Cart admin/tools/ section

(do not use the sql upload feature, that usually does not work well).

If the Zen Cart sql tool returns errors, it's usually caused by its bugs. In that case use phpMyAdmin for example (don't forget to add your table prefixes if any!).

3. Copy the file superglobals.php
   from: superglobals-plus_v1.24\catalog\includes\functions\extra_functions
   to your shop's: \includes\functions\extra_functions\

4. Copy the file stylesheet_superglobals.css to your catalog template css directory:
   includes\templates<YOUR TEMPLATE>\css\

5. Copy the file
   from: includes\templates\template_default\common
   to: includes/templates/<YOUR TEMPLATE>/common/
   (if the subdirectory 'common' doesn't exist under <YOUR TEMPLATE>, create it)

TOpen the tpl_main_page.php file and, just before the ending </body> tag, add:

> 
> 6) Open the file admin/includes/footer.php and, just before the ending </body> tag, add:
> 
> ```php
<!--bof- superglobals display -->
<?php
// BEGIN Superglobals
if(SHOW_SUPERGLOBALS_ADMIN == 'true') echo superglobals_echo();
// END Superglobals
?>
<!--eof- superglobals display -->

7. Ready
   (or ready to install the admin version if you like).

One thing that seems to be missing in this excellent utility (SuperGlobals Plus) is a legend describing the meaning of the text colors. At first, I thought that red/green was referring to the lifetime of the objects, but now I think that the colors simply describe the type of the objects:

GREEN: array, string, integer, boolean, etc. (PHP built-in types).
RED: object (class instance)
BLUE: resource (handle, mysql link, result, etc.)
GREY: superglobals message

Please correct if I am mistaken.

Daniel

Hi Daniel,

thanks for the readme update :smile:

The coloring is probably not very logical. I just quickly added some colors at the time to make it a bit easyer to read.

Not all types have specific colors, and the colors are inherited. So, for example, because $GLOBALS is an array (colored green by the css) all childs of $GLOBALS will become green, unless another color has been assigned to the child. Objects are colored red, and all it's childs (that do not have a specific color assigned) will be red too.

You can see in the stylesheet how it's done:

#superglobals .superglobals_array {
  border-left-color: green;
  color: green;
}
#superglobals .superglobals_object {
  border-left-color: red;
  color: red;
}
#superglobals .superglobals_empty {
  color: gray;
}
.superglobals_resource {
  color: blue;
}
.superglobals_type {
  color: black;
}

A small improvement might be to add a border at the bottom of each list (ul). I think that makes it a bit easier to see to what parent the childs belong.

Change:

#superglobals ul {
  border: 1px solid black;
  border-width: 0 0 0px 1px;
  border-left-color: black;
}

To

#superglobals ul {
  border: 1px solid black;
  border-width: 0 0 [B]1[/B]px 1px;
  border-left-color: black;
}

Or maybe even turn the ul's into boxes, like this:

#superglobals ul {
  border: 1px solid black;
  border-width: [B]1px;[/B]
  border-left-color: black;
}
```(now I look at it I wonder why I have not done it like this in the first place...)

paulm:

Hi Daniel,

thanks for the readme update :smile:
You are very welcome but really, thank YOU for this great contribution. What I did is negligible comparing to your work.

BTW, I discovered a typo in my readme update: I mistakenly omitted the filename in step 5. Instead of: "5) Copy the file ", it should read: "5) Copy the file tpl_main_page.php"

And thank you for the clarification regarding the text coloring.

Daniel

Anyone using this most helpful add-on for ZC 1.38a admin should note that there's another change required for full function. In \YOURADMIN\index.php, make the following change (after saving the file!) near the very end of the file:

</div>
<!--bof- superglobals display -->
<?php
// BEGIN Superglobals
if(SHOW_SUPERGLOBALS_ADMIN == 'true') echo superglobals_echo(); 
// END Superglobals
?>
<!--eof- superglobals display -->
</body>
</html>

I just submitted the update for this great debug tool to the "Free Software Add-ons" so that it is usable under 1.5.0.

lat9:

Anyone using this most helpful add-on for ZC 1.38a admin should note that there's another change required for full function. In \YOURADMIN\index.php, make the following change....Funny, I never really noticed that superglobals did not show on the admin index page :smile:

lat9:

I just submitted the update for this great debug tool to the "Free Software Add-ons" so that it is usable under 1.5.0.Great, I am very happy to see this update! Just installed on 1.5.0BETA :bigups:

The update is now available from the "Free Software Add-ons".

Thanks, paulm, I didn't know you were still "around". This is the first add-on that gets installed on any of my Zen Cart installations!