<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<?xml-stylesheet type="text/xsl" href="./modx.smith.en.xsl"?>
<mod xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.phpbb.com/mods/xml/modx-1.2.2.xsd">
	<header>
		<license>http://opensource.org/licenses/gpl-license.php GNU General Public License v2</license>
		
		<title lang="en">IP Search</title>
		
		<description lang="en">
			Search for a user by IP address or host name.
		</description>
		
		<author-notes lang="en"><![CDATA[
One of the things phpBB does not provide for administrators is an easy way to search for forum users based on IP addresses.  To perform such a search for an exact IP, one must first find a post made by a user from that address.  That can rather difficult to accomplish in some cases, especially when dealing with dial-up users, who may have hundreds of IPs on record.

IP Search adds a new section to the Administration Panel to make this easier. You can enter an IP address and get a list of everyone that has recorded activity from that address.  You can also enter a hostname to search; the modification will look up the IPs for that host and search for all of them.  If a certain user is being a problem, you can view all of the IP addresses used for their account by entering their username, as well.

Two wildcards are supported in IP address searches, the * for matching many characters and the _ for matching single characters.  This allows searches for IPs like 127*, 127.*.1, 127.0.*, 12_.0.0.1, 1_7.*, and so on.

After installing, IP Search will be added to the Admin Panel under the User Security section of the Users and Groups page and also under the phpBB Smith section of the .MODs page.
		]]></author-notes>
		
		<author-group>
			<author>
				<realname>Jeremy Rogers</realname>
				<username>Thoul</username>
				<homepage>http://www.phpbbsmith.com</homepage>
			</author>
		</author-group>
		
		<mod-version>2.3.3</mod-version>
		
		<installation>
			<level>easy</level>
			<time>120</time>
			<target-version>3.0.4</target-version>
		</installation>

		<history>
			<entry>
				<date>2009-03-27</date>
				<rev-version>2.3.3</rev-version>
				<changelog lang="en">
					<change>More bug fixes on varibles not defined in certain situations.</change>
				</changelog>
			</entry>
			<entry>
				<date>2009-03-24</date>
				<rev-version>2.3.2</rev-version>
				<changelog lang="en">
					<change>More bug fixes on varibles not defined in certain situations.</change>
					<change>Added ModX install instructions.</change>
					<change>Moved admin template files.</change>
				</changelog>
			</entry>
			<entry>
				<date>2009-03-14</date>
				<rev-version>2.3.1</rev-version>
				<changelog lang="en">
					<change>Bug fixes for various undefined variable warnings.</change>
				</changelog>
			</entry>
			<entry>
				<date>2009-03-12</date>
				<rev-version>2.3.0</rev-version>
				<changelog lang="en">
					<change>Added searching of multiple usernames (including guests) at one time.</change>
					<change>Added searching of multiple IPs at one time.</change>
					<change>Added first and last visit dates to results, where available. phpBB doesn't record a time setting for some IP records</change>
					<change>Added options to automatically perform a second search based on results of a search.</change>
					<change>Results are now sorted by username.</change>
					<change>Updated Danish language file.</change>
				    <change>Added German language file.</change>
				</changelog>
			</entry>
			<entry>
				<date>2009-03-10</date>
				<rev-version>2.2.0</rev-version>
				<changelog lang="en">
				    <change>Added search options for selecting what areas are searched.</change>
				    <change>Added better grouping of multiple results for a user in a list of several users.</change>
				    <change>Added Quick Tools to results for easier moderation and banning of users found in a search.</change>
				    <change>Added toggle to hide/show the Results Legend.</change>
				    <change>Added Danish, Slovak, and American English language files. Thanks to Stoker and WhiteWolfSix for the translations.</change>
				    <change>Fixed bug with username search popup.</change>
				    <change>Fixed bug with an empty IP address by a valid hostname, which could happen on boards converted from phpBB 2 on a Windows OS.</change>
				    <change>Changed admin authorization type from word censors to users.</change>
				    <change>Changed hostnames to be displayed by hovering over the IP address, to lessen table stretching issues that can hide results. Not a total fix, but I can't completely prevent stretching with the basic ACP layout.</change>
				    <change>Made few internal things a little more simplified.</change>
				    <change>Tested on phpBB 3.0.4, working fine as usual.</change>
				</changelog>
			</entry>
			<entry>
				<date>2008-01-31</date>
				<rev-version>2.1.0</rev-version>
				<changelog lang="en">
				    <change>Added "Do not look up hostnames" checkbox.</change>
				    <change>Converted files to Unix format, lang file to UTF-8.</change>
				    <change>Small XHTML validity change in one of the template files.</change>
				    <change>Dropped ModX files from the package.</change>
				    <change>Tested on phpBB 3.0.0 Gold, working great.</change>
				</changelog>
			</entry>
			<entry>
				<date>2007-08-02</date>
				<rev-version>2.0.1</rev-version>
				<changelog lang="en">
				    <change>Removed a check that caused an error on some servers.</change>
				</changelog>
			</entry>
			<entry>
				<date>2007-07-29</date>
				<rev-version>2.0.0</rev-version>
				<changelog lang="en">
				    <change>Updated for phpBB 3 RC3/RC4.  No longer compatible with RC1 or RC2.</change>
				    <change>Fixed an error that prevented guest posts from being listed in search results.</change>
				    <change>Prevented an SQL error when there were guest results but no registered user results.</change>
				    <change>Merged the lang file edit into the included language file, so now there are no file edits needed at all.</change>
				    <change>Added Search by User feature.</change>
				    <change>Added N/A as results for fields that are not searched on user types.</change>
				    <change>Changed the label on the registered user results from Users to Registered Accounts to prevent any confusion over the definition of Users in the legend.</change>
				    <change>Updated MODX stylesheet.</change>
				</changelog>
			</entry>
			<entry>
				<date>2007-07-02</date>
				<rev-version>1.1.0</rev-version>
				<changelog lang="en">
				    <change>Updated for phpBB 3 RC2.  No longer compatible with RC1.</change>
				    <change>Added use of RC2's sql_like_expression.</change>
				    <change>Renamed language file in anticipation of changes in the next phpBB 3 version.</change>
				    <change>Added results legend.</change>
				    <change>Added support of _ wildcard for single character replacements.</change>
				    <change>Added lookups of hostnames on wildcard IP searches.</change>
				    <change>Updated MODX stylesheet.</change>
				    <change>Added license file.</change>
				</changelog>
			</entry>
			<entry>
				<date>2007-06-01</date>
				<rev-version>1.0.0</rev-version>
				<changelog lang="en">
				    <change>Bugfix on the host name display in error messages.</change>
				    <change>Upgraded the install.php to place a link in the .MODs section of the ACP.</change>
				</changelog>
			</entry>
			<entry>
				<date>2007-05-00</date>
				<rev-version>0.7.0</rev-version>
				<changelog lang="en">
				    <change>Another bug fix on a "no results found" message.</change>
				</changelog>
			</entry>
			<entry>
				<date>2007-05-25</date>
				<rev-version>0.6.0</rev-version>
				<changelog lang="en">
				    <change>Bug fix for an error displayed if user results were found and guest results were not.</change>
				    <change>Bug fixes on a couple of "no results found" messages.</change>
				    <change>Improved internal documentation.</change>
				</changelog>
			</entry>
			<entry>
				<date>2007-05-25</date>
				<rev-version>0.5.0</rev-version>
				<changelog lang="en">
				    <change>First release of IP Search for phpBB 3.</change>
				</changelog>
			</entry>
		</history>
	</header>
	
	<action-group>
		<copy>
			<file from="root/*.*" to="*.*" />
		</copy>
		
		<diy-instructions lang="en">Run install.php by visiting it in your web browser, for example:
http://www.yoursite.com/phpBB3/install.php
Follow the instructions provided to install the database parts of this
modification. When finished, delete install.php from your site.</diy-instructions>
	</action-group>
</mod>
