Compatibility
The plugin works on both EE v1.x and v2.x.
Installation
EE v1.x
Place the pi.phpstringfun.php file in the /system/plugins directory.
EE v2.x
Create in the /system/expressionengine/third_party directory a directory /phpstringfun, then place the pi.phpstringfun.php file in there.
Parameters
array_index
If the function’s result is an array, such as explode, the array_index parameter allows you to set which result from the array to produce. Also see the separator parameter.
function (required)
PHPStringFun requires the “function” parameter to be a PHP string function. Some functions cannot be used. These are fprintf() and implode().
Those that can be used are: addcslashes, bin2hex, chop, chr, chunk_split, convert_cyr_string, convert_uudecode, convert_uuencode, count_chars, crc32, crypt, echo, explode, get_html_translation_table, hebrev, hebrevc, html_entity_decode, htmlentities, htmlspecialchars_decode, htmlspecialchars, join, levenshtein, localeconv, ltrim, md5_file, md5, metaphone, money_format, nl_langinfo, nl2br, number_format, ord, parse_str, print, printf, quoted_printable_decode, quotemeta, rtrim, setlocale, sha1_file, sha1, similar_text, soundex, sprintf, sscanf, str_ireplace, str_pad, str_repeat, str_replace, str_rot13, str_shuffle, str_split, str_word_count, strcasecmp, strchr, strcmp, strcoll, strcspn, strip_tags, stripcslashes, stripos, stripslashes, stristr, strlen, strnatcasecmp, strnatcmp, strncasecmp, strncmp, strpbrk, strpos, strrchr, strrev, strripos, strrpos, strspn, strstr, strtok, strtolower, strtoupper, strtr, substr_compare, substr_count, substr_replace, substr, trim, ucfirst, ucwords, urlencode, vfprintf, vprintf, vsprintf, wordwrap.
reverse
Some functions work better if the order that the plugin accepts parameters is reversed. For instance, the explode function works better when reverse is set to “yes”, allowing the delimiter to be set as a parameter and the string to come within the body of the plugin.
par1, part2, par3, par4 and par5
What comes between the tags is essentially the initial parameter. Phpstringfun accepts up to five additional parameters (par1, part2, par3, par4 and par5) needed by the chosen PHP string function. These parameters must be in sequence, so that if there’s a par2 there must also be a par1.
To know how many parameters the function takes, see its PHP documentation.
separator
If the output of the plugin is an array, the separator parameter lets you set which character separates the items in the array. Also see the array_index parameter.
Examples
For example:
{exp:phpstringfun function="rtrim" par1="st"}test{/exp:phpstringfun}
would return “te”.
{exp:phpstringfun function="explode" par1="," separator="|" reverse="y"}one,and.two,and,three{/exp:phpstringfun}
would return “one|and.two|and|three|” while
{exp:phpstringfun function="explode" par1="," array_index="2" reverse="y"}one,and.two,and,three{/exp:phpstringfun}
would return “and”.
Thanks
Thanks to Derek Jones for making me clean up the (rather sparse) code and Ingmar Greil and Mark Bowen for giving it lovin’ on the forums.
Changelog
1.2 (2010 Sep 15)
- added compatibility with EEv2.x
- added array_index and separator parameters in order to select result or results from an array
- added reverse parameter to enable listing the parameters in reverse (easier for some PHP functions, such as explode)
Tue 14 Sep ’10
11:39pm
Adam Khan
This problem has come up before (see http://expressionengine.com/archived_forums/viewthread/144864/)—I’ll take a look and see if I can figure out what’s happening.
Tue 14 Sep ’10
11:54pm
Mike
Thanks Adam. I want to explode a custom field of ids (123|43|75) so I can use them separately. If the explode function returns an array I don’t understand how phpstringfun would handle that.
Wed 15 Sep ’10
12:11am
Adam Khan
Yes, it would have to check whether the result is an array and if so, output it as an array, taking a new parameter as the separator character.
Wed 15 Sep ’10
12:00pm
Adam Khan
Mike, I’ve updated the plugin to allow output from explode, but I think phpstringfun is not really worth using for that. To be honest, I never use the plugin myself. I find it easier to just use PHP wherever required in an EE template. The majority of my EE templates have PHP enabled.
I use explodes whenever necessary combined with foreaches. I generally keep PHP at the default output parsing stage, and if that makes a PHP variable inaccessible, I just embed a template and pass the PHP variable.
Wed 15 Sep ’10
1:31pm
Mike
Thanks Adam! I’ll give both a try
Wed 15 Sep ’10
6:21pm
Mike
Thanks Adam, I’ll try both methods.
Sun 26 Sep ’10
4:08pm
Dean
New to EE here, I am getting the error:
Fatal error: Call to a member function fetch_param() on a non-object in / [ …edited…] system/expressionengine/third_party/phpstringfun/pi.phpstringfun.php on line 36
My call looks like:
{exp:phpstringfun function=“ucwords”}{field_x}{/exp:phpstringfun}
What am I doing wrong?
Sat 2 Oct ’10
3:07am
Stephen
Hi Adam,
I\ve just upgraded PHPStringFun in EE2.1 from version 1.1 (EEv1) to version 1.2 (EEv1) and immediately got the same error as Dean mentions above on one of the pages of my site that uses this plugin:
Fatal error: Call to a member function fetch_param() on a non-object in /home/myaccount/public_html/mysystem/expressionengine/third_party/phpstringfun/pi.phpstringfun.php on line 36
Here’s the code I’m using in the template that’s causing this (which worked fine and without error with the previous version):
{exp:phpstringfun function=“urlencode”}http://www.mywebsite.co.uk{page_uri}{/exp:phpstringfun}
Not sure if this is a bug with the latest version, or if I’m doing something wrong with my code/tags that has now been tightened up on with the new version?
Thanks,
Stephen
Tue 5 Oct ’10
12:57am
Nik
I am also haveing problems with phpstringfun as the 2 users above:Fatal error: Call to a member function fetch_param() on a non-object in /home/myaccount/public_html/mysystem/expressionengine/third_party/phpstringfun/pi.phpstringfun.php on line 36
Tue 5 Oct ’10
10:04am
Adam Khan
My apologies people, I’ve been swamped with work and didn’t have time to get to this.
Turns out I didn’t test the plugin properly in EE2. The fatal error is now fixed in v1.2.1.
Wed 6 Oct ’10
1:47am
Nik
Thanks Adam! Having issues downloading the new 1.2.1? I get the the agree button, then I get an url doesn’t exist error?
Wed 6 Oct ’10
7:06am
Adam Khan
Oops, file renamed correctly.
Sun 28 Nov ’10
11:49pm
Bob
When I download the file, all I get is the EE1 version. I would love to get my hands on the EE2 version!
Thanks,
Bob
Thu 23 Dec ’10
2:45pm
Uno
Hi adam,
I would like to use str_replace. but I couldn’t find example.
{exp:phpstringfun function=“str_replace” par1=”.jpg” par2=“_t.jpg”}{photo}{/exp:phpstringfun}
But it doesn’t work.
So, could you give me correct example?
Mon 10 Jan ’11
12:37pm
Adam Khan
Uno, sorry for the delay in replying—I’ve been out of commission.
PHP’s String Replace function http://php.net/manual/en/function.str-replace.php) has as its parameters $search, $replace, $subject, so it would help to use the plugin’s reverse parameter then do as follows:
{exp:phpstringfun function=“str_replace” par1=“_t.jpg” par2=”.jpg” }{photo}{/exp:phpstringfun}
Sun 16 Jan ’11
12:24am
Claire
For some reason it doesn’t seem to be working with nesting. Am I doing something wrong?
{exp:phpstringfun function=“htmlentities”}{exp:phpstringfun function=“nl2br”}{title}{/exp:phpstringfun}{/exp:phpstringfun}
Sun 3 Apr ’11
10:03pm
Joff
Hi Adam,
I’m trying to use PHPStringFun (v1.2.1 on EE 2.x) on a segment in a title element, using the ucwords function, but it’s not applying anything:
{exp:phpstringfun function=“ucwords”}{segment_2}{/exp:phpstringfun}
I’ve changed the function to “strtoupper” and it works fine. If I change the {segment_2} to a hardcoded string, e.g.:
{exp:phpstringfun function=“ucwords”}this is lowercase{/exp:phpstringfun}
then I get the correct desired result.
Any suggestions as to what I’m doing wrong?
Hopefully the solution is staring me in the face!
Fri 3 Jun ’11
10:24am
lets
I’m having the same problem as Clair, is there a way of chaining functions?
I’m trying to replace spaces with ‘-’ and make it lowercase, but just the closing tag is displayed.
Wed 15 Jun ’11
4:41pm
Dan
Just noticed that “addslashes” function doesn’t exist in this plugin, but “stripslashes’ is in there.
It was really easy to add it to the plugin.
Just thought you might want to update that little thing.
Wed 20 Jul ’11
8:33pm
Tom
This worked well for me but it would be really nice if it worked with nesting.
Fudged my way around it with what I needed to do but its ugly and I can see a situation arising where I will have to nest some of these functions and be SOL.
Mon 8 Aug ’11
9:25pm
Jeff
Desperately needs nesting..
Mon 15 Aug ’11
11:09pm
Tom Chapin
When I extracted the archive for phpstringfun 1.2.1, I was confused because there was only one file (“pi.phpstringfun.php”) contained inside and I couldn’t tell if it was the file for EE1 or EE2.
I went ahead and created a folder in my EE2 installation at /system/expressionengine/third_party/phpstringfun/ and I placed the pi.phpstringfun.php file there inside it. Everything seems to be working correctly when I tried it out.
Tue 20 Sep ’11
7:57am
Sten Van den Bergh
str_replace also doesn’t work for me. It replaces the whole word with the par2 parameter. So this code:
{exp:phpstringfun function=“str_replace” par1=“o” par2=”+” }hello world{/exp:phpstringfun}
outputs “+”
Wed 5 Oct ’11
3:53am
Allan White
A question about this plugin (and by extension, the PHP functions it enables): Can it encode/escape for Javascript? I need to inject some HTML into a JS function that’s part of an EECMS template, and it would be soooo slick to do it on the fly. Example of the formatting here: http://www.htmlescape.net/stringescape_tool.html It seems different than HTML entity encoding. Thanks! Neat concept.
Sat 15 Oct ’11
7:49am
Chris
Explode won’t work with a array_index of 0 because 0 is false…
change:
if ($array_index)
to:
if (isset($array_index))
Somewhere…
Sat 15 Oct ’11
7:51am
Chris
Also,
Be aware that ee trims the params or something so par1=” : ” won’t work :(
Wed 29 Aug ’12
9:53pm
Nathan Pitman
Hi there, I’ve been using this plug-in for a while on a site but a recent server upgrade to a more current version of PHP has the substr_count function playing up. I’ve not been able to nail the exact cause but it seems that the addition of the offset parameter might have something to do with it. :)
Thu 25 Oct ’12
12:00pm
Frank Heijkamp
I had problems with the plugin under EE version 2, had to comment all version 1 code out. Is it only me having this problem?
// global $TMPL;
// $version = “”;
// if ( $TMPL )
// {
// $version = “1”;
// }
// else
// {
// $version = “2”;
// }
// if ($version == “2”)
// {
// keep EE version 2 code
$this->EE =& get_instance();
$TMPL = $this->EE->TMPL;
// }
Tue 2 Jul ’13
1:20pm
spss in research methodology
Formatting strings in PHP is helpful when you want to convert data from one format to another, such as integer to float, or to change the string’s appearance. Thanks for sharing.
< ahref=“http://www.spss-research.com/”>spss in research methodology</a>
Fri 19 Jul ’13
7:32am
Jones
It is a general purpose language designed to make dynamic web pages. Strings, which are sequences of characters meant to be read literally, are used in PHP to read in data as well as display information on a web page. Thanks for sharing.
improve billing and collections
Wed 21 Aug ’13
10:26am
Rita
Thanks. <a >Great</a>
Wed 21 Aug ’13
10:28am
Natasha
Thanks for your post. I was stuck here in the middle of my PHP project due to not knowing the functions of some PHP string functions. free money online now Your article provided me a clear picture about those strings and the coding. It was a god attempt.
Wed 21 Aug ’13
10:33am
Frank
Natasha you naughty SPAM bot.
Thu 22 Aug ’13
8:30am
illumine
Thank you for this awesome post. I have been having a number of problems with my self defined functions. Well these string functions seems to be more than just a help to me.
“solar panel”:http://www.illumineenergy.com/home-power-system/basic-500w-solar-inverter-ieshp01/
Thank you once again guys.
Thu 22 Aug ’13
9:34am
Frank
Oh yes, solar inverters are absolutely on topic here and right now.
Fri 23 Aug ’13
5:07am
ron
you people need to support some people like us who build links for a living man. isn’t humanity still on this planet or what….
Fri 23 Aug ’13
8:58am
Frank
Please keep this discussion on-topic. In no way pollute it with link SPAM.
Fri 30 Aug ’13
5:12pm
paper writing service
Avail the best paper writing service and get the countless benefits.
Wed 25 Sep ’13
11:43am
Soha
Find Inspiring Quotes On Facebook. It’s Quick, Easy & Free. Join Now!
research paper writers
Tue 8 Oct ’13
7:10pm
Greg
Thanks for taking this opportunity to discuss this, I appreciate with this and if you have some more information please share it with me.
picture retouching
Wed 30 Oct ’13
9:47am
www.platinumpath.co.uk
www.platinumpath.co.uk Congratulations to a brilliant effort in publishing your article. One can be more informative as this. There are many things I can know only after reading your wonderful article.
Wed 30 Oct ’13
9:48am
www.novusevents.co.uk
www.novusevents.co.uk On the Net, graduate can get pre written essay papers, but some papers contained many mistakes, so I want to advise you the best firm I have worked with, where highly qualified staff is ready to aid you, so don’t hesitate and buy critical analysis essays.
Thu 31 Oct ’13
4:19am
Ali
Being the richest man in the cemetery doesn’t matter to me. Going to bed at night saying we’ve done something wonderful, that’s what matters to me.
infographic company
Mon 4 Nov ’13
10:37am
darrendemers12
Wonderful subject and fair ... you simply have to do more study to come to be many more specific. Yet it’s not that bad, it’s amazing
http://www.centersforwholehealth.com/
http://www.dothanhealthaids.com/
http://www.healingtouchhealthcare.com/
http://www.healthsourcemedicalbilling.com/
http://www.tucsonarizonahealthinsurance.com/
http://www.heraklionbusiness.com/
http://www.finnishdigibusiness.com/
http://www.businessflares.com/
http://www.smallbusinessmarketingcalendar.com/
http://www.business-taxpros.com/
Sat 9 Nov ’13
10:16am
eavedrop441
This is the kind of blog I want to visit to start my day. I also admire your selection. I’ll be back soon for more discussions. As of the moment I’ll just leave a quick post just letting you know I love your blog.http://www.salaisetkansio.net
http://www.studyabroad-europe.net
http://www.vergader-locatie.net
http://www.zebrastripecontrasters.net
http://www.adolfocamarillobirthday.com
http://www.android-forensic-expert.com
http://www.android-forensic-experts.com
http://www.android-forensics-expert.com
http://www.android-forensics-experts.com
http://www.bloomingtongallery.com
Wed 13 Nov ’13
2:19am
credit report
http://www.myfreecreditreportx.com/what-is-my-credit-score-free-question-answered Your posts are most helpful! what is my credit score free
Tue 19 Nov ’13
8:49am
Rodene
Year 2012 has been quite eventful. SRSG also witnessed events and evolved in terms of business verticals, technologies, people and processes.
Broadcast RODE audio
Grass valley automation
Broadcast Technical support services
Wed 20 Nov ’13
11:00am
health-and-babies
I do like this media day gopro and yes everything now makes really what I would wanted. I like it then. health-and-babies
Wed 20 Nov ’13
11:01am
naturalway2health
I am glad to find your impressive way of writing the post. Now it become easy for me to understand and implement the concept. naturalway2health
Wed 20 Nov ’13
11:11am
sayirt
I AM a fan of your blog. Thanks for sharing this information.
Natural polymer suppliers
Thu 21 Nov ’13
12:12pm
rodene
Green Power International was established in early 2002 in close cooperation with MWM GmbH (formerly Deutz Power System GmbH).
Uninterrupted power
Rotary UPS system
Coke oven gas
Thu 21 Nov ’13
12:13pm
Green
Green Power International was established in early 2002 in close cooperation with MWM GmbH (formerly Deutz Power System GmbH).
H2S removal processes
Gas based power
Producer gas
Wed 27 Nov ’13
4:28am
www.holdempokerradio.com
I think I am not the only one having all the entertainment here keep up the excellent work www.holdempokerradio.com
Wed 27 Nov ’13
4:29am
www.arizonacasinobustours.info
The best are many.It is true’ly hard to say which one is the best, I recollect 8 seconds making me shed a tear thou!!! www.arizonacasinobustours.info
Thu 28 Nov ’13
7:21am
dissertation services
A lot of students have discovered it really hard to carry out the research all by themselves and this is why we have offered them a chance to disclose their problems with us so that we can lead them in dissertation services
and help them in doing this daunting task.
Sun 1 Dec ’13
4:37am
eavedrop44
I want to visit to start my day. I also admire your selection. I’ll be back soon for more discussions. As of the moment I’ll just leave a quick post just letting you know I love your blog.repairbadcreditcar.com |
Sun 1 Dec ’13
4:38am
eavedrop44
I want to visit to start my day. I also admire your selection. I’ll be back soon for more discussions. As of the moment I’ll just leave a quick post just letting you know I love your blog.californiacarstore.com |
Tue 14 Sep ’10
11:23pm
Mike
When using the explode function how would print the array? The tag just outputs “array”