UniAdmin

From WoWRosterWiKi
Jump to: navigation, search
WR.net

Important note: When you edit this page, you agree to release your contribution into the public domain.
If you do not want this or can not do this because of license restrictions, please do not edit.

Contents


UniAdmin

Current version: 0.7.9
Updated: 22:05, 18 June 2007 (PDT)
Authors: Zanix | Matt Miller

Forum | Project on Google Code | Issue Tracker | Download | Source

I bet you're wondering either what this is and/or how to use it, so:

This is a system used to keep the users (who use UniUploader) addons, logos, and settings updated.
When you upload an addon to this system, and hit "update" in UU, UU will look up the "Synchronization URL" (the one in the frame on the left) UU will then proceed to download any update(s) that are in any way different than the copy stored on the user's hard drive, UU will replace the addon with the new copy of the addon from this system.


Requirements


Recommended Tools


Installation

  1. Create a new database (eg. uniadmin)
  2. Upload the contents of the zip file to your webserver
  3. After FTPing, CHMOD the following folders to 0777, or change NTFS file permissions for these folders to make them available as "Everyone - Write" on a Windows machine.
[uniadmin]
  addon_temp
  addon_zips
  cache
  logos

4. Go to your UniAdmin install on the web and follow the instructions


The admin user is created on installation
Read the help page for additional info.


Upgrading

  1. Run index.php?p=upgrade and follow the instructions


Upgrade from v0.7.0


Upgrade from v0.7.5


Thanks

Special Thanks To:
sturmy French localization
fubu2k
Carasak
Shadowsong
German localization
Zajsoft Great modifications to AddOn uploading, providing a better .toc file scanner
Zeryl Thanks for help with parsing strings into multi-dimensional arrays
Thanks for the WoWAce module code


FAQ

  1. First, hover your mouse over each setting, you'll get a tooltip with the corresponding part of the UniUploader interface.
  2. If you are still confused
    • Manually configure UniUploader with the settings needed for your config.
      • Open the settings.ini and you'll see all the settings just like in the Settings Management page.
    • Or just upload your copy of settings.ini to the settings page in UniAdmin.


Support

For any support issues, questions, comments, feedback, or suggestions
please go to the support forums here - http://www.wowroster.net/Forums/viewforum/f=24.html


License

UniAdmin is licensed under a Creative Commons
"Attribution-NonCommercial-ShareAlike 2.5" license.
Short summary: http://creativecommons.org/licenses/by-nc-sa/2.5
Full License: http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode


Regarding Attribution:


Regarding ShareAlike:


For any reuse or distribution, you must make clear to others the
license terms of this work. Any of these conditions can be waived if
you get permission from the dev team at wowroster.net.


UniAdmin uses the following libraries as well






Known Bugs / Gotchyas


Change Log

Key:

[~] Fixed

[+] Added

[!] Changed


0.7.9

  • [~] WoWAce addon list works again
    WoWAce changed the addon list format to XML and removed the old format
    Thanks to Exerladan for the code
  • [~] HTML fixes and changes
  • [!] All the comment headers to our new format
  • [!] The updater has been slightly modified, shouldn't affect anyone
  • [!] Using version_compare() instead of a string compare when comparing versions of UA
  • [+] PURGEFIRST setting
  • [+] Force addon list reload to WoWAce module
  • [+] Ability to delete Un-Scanned addons
  • [+] Message when an addon is deleted
  • [+] Images for new settings


v0.7.8

  • [~] Upgrader had a typo
  • [~] GETDELETEADDONS wasn't quite working correctly, it should be ok now
    I changed some of the variables around and didn't test, I'm sorry


v0.7.7

  • [~] Addon processing now checks if the addon zip exists before trying to unlink it
  • [~] UA does not attempt to delete temp upload file, move_uploaded_file already does this
  • [~] addon xml output htmlspecialchars() encoded
  • [~] Addon file XML output now outputs <addon /> where there are no addons
  • [!] Now using a blacklist for invalid files
    ade,adp,bas,bat,chm,cmd,com,cpl,crt,doc,eml,emf,exe,hlp,hta,inf,ins,isp,jar,js,jse,lnk,
    mdb,mde,msc,msi,msp,mst,pcd,pif,ppt,py,rar,reg,scr,sct,shs,url,vbs,vbe,wsf,wsh,wsc,xsl
  • [!] Returned to old method for figuring out file extention
  • [!] Paginate tpl variable was removed from addon page
  • [!] uniadmin_settings.enabled is now a tinyint(1) field
  • [!] New look for the SV file management section
  • [+] Addon removal settings
  • [+] Two new settings for jUU HOMEURL and FORUMURL


v0.7.6

  • [~] slashes are now stripped in the stats module
  • [~] ADDVARVAL2 is now a password field since it's usually a password
  • [~] Edited pclzip.lib.php detection of windows to something that servers don't block
  • [~] Removed curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
    It isn't needed and some servers block this option
  • [~] get_remote_contents file get function in include/uniadmin.php
  • [~] Removed umask in write_file function in include/uniadmin.php
    These two were causing the no toc errors for wowace addons
  • [~] Added improper module name detection in index.php, to eliminate remote file inclusion hacks
  • [~] Reduced the queries on the stats page down to 9, Thanks alot PleegWat!
  • [~] Sorting on stats page
  • [~] Added user agent matching for jUU so compat mode setting will be active
  • [~] Logo file paths are now determined by the current url
  • [~] settings.ini scanner will not scan certain values (IE: account name)
  • [~] SQL queries will never show to anonymous users
  • [~] Links in installer will now properly point to index.php instead of install.php
  • [~] XML output is now encoded properly with the right headers
  • [~] TOC scanner, found a few addons' toc files that it didn't catch properly
  • [!] UA will now die with an error if php is not 4.3 and higher
  • [!] The Help tab is now "selected" when there is no page defined in the url
  • [!] UA now only accepts and scans certain file types for addons
    lua,toc,txt,tga,blp,ttf,xml,wav,mp3,nopatch
    UniAdmin will notify you if a file was skipped
    If there are other, NON-executable file extensions, let us know!
    PclZip has an option to run a pre-extract function
    function pclzip_pre_extract() in include/uniadmin.php
    Files not on the allowed list are not even extracted
  • [!] Addon note tooltip now shows over entire 'name' cell
  • [!] Tables that use the js sort are not initially sorted, improving page load times
  • [!] Error message rows are now reddish
  • [!] Logo module has been edited so different image file types could be used in the future
  • [!] Removed `download_url` field from logo table, `filename` is used now
  • [!] All remote addons (wowace) will now be stored locally
    This is so UA admins can control what addon version UU users download
  • [!] Full path addon detection
    There is now 3 options [automatic] [yes] [no]
      • Automatic will attempt to auto-detect if the addon should be treated as full path or not
    Addon XML variable "full_path" is now set if the addon should be treated as full path
      • 0 = extract to WoW/Interface/AddOns/
      • 1 = extract to WoW/
  • [!] Addon xml file list is only outputted if there are addons in the UA db
  • [!] Addon xml output is now sorted by required/optional, then by name
  • [!] Logo output is sorted now sorted numerically
  • [!] Setting and sv list output is sorted by name
  • [!] function get_file_ext() now uses pathinfo
  • [!] addon xml filename="" attribute is now the full url path to the file
  • [+] addon_zip folder scanning
    UniAdmin now scans this folder and presents you with addon zips that have not been scanned into the database
    Use this feature to ftp larger addon zips to UniAdmin
  • [+] Addon notes to addon xml output
  • [+] New get settings mode, xml output
    Use ?OPERATION=GETSETTINGSXML
  • [+] Now using the minixml library to generate xml output in interface.php
    http://minixml.psychogenic.com
    This allows proper formatting and escaping
  • [+] New logo image types are allowed
    Logo image types allowed are 'jpg,jpeg,png,ico,gif'
    Others could have been added, but some formats are too large to be downloaded quickly
  • [+] Global addon deletion, to delete every addon from your UniAdmin install
  • [+] Error handling class
    Catchable PHP errors are now displayed at the bottom of the page above sql queries
  • [+] is_ua_admin() for an easier way to check if the user is an admin


v0.7.5

  • [~] Removed all dead files
  • [~] Massive code cleanup
  • [!] Overhauled the addons page
  • [~] Addon file paths are now determined by the current url
  • [~] Simplified main SQL query, now only one query
  • [~] SVLIST is now scanned when exporting settings.ini
  • [~] Fixed level 1 users so they can change locale and theme
  • [~] Not using $pipe_sep in interface.php
  • [~] Made a call to $uniadmin->config() after changing settings in UA config so they will show correctly
  • [~] Notice userN when editing self user in User Config page
  • [~] Fixed error on UA config page dealing with default style
  • [~] index.php to use the page variable constant defined in constants.php
  • [+] Added installer and upgrader
    Moved files around in zip package now that UA has an installer
    PRIMARYURL, SYNCHROURL, RETRDATAURL are set with default values on install
    If config.php doesn't exist, UA will direct to the installer
  • [+] Homepage and filename to xml in interface.php
  • [+] Implemented code from Zajsoft (thanks a bunch!)
  • [+] Addon list sorting
  • [+] File size is now calculated
  • [+] Directory tree file listing (html list output)
    Big thanks to Zeryl on this, without him, this would not be here
  • [+] Added password confirmation
    If you edit yourself, you need to enter old password
    If your level > user, then no old password is needed
  • [+] If adding a new user, and there is a form validation error, some of the info will be still in the form (name, level, lang, style)
  • [+] Added ua_die() to kill UA when needed with a message and debug info
  • [+] Added remote checking for new UA version
    There is an option to turn this off in uniadmin config
  • [+] Added WoWAce module, now you can get addons from wowace.com
  • [+] Added a function to grab a remote file's contents $uniadmin->get_remote_contents()
  • [!] Addon zips are loaded on the assumption that they extract to Interface/AddOns/, there is a switch on the upload form to change this action
  • [!] Simplified the upload process
    Only 3 fields; Required, Full Path, Select File
  • [!] Greatly improved .toc file detection
    Most needed fields are scanned from the .toc file
    You can use the addon details page to edit fields
  • [!] get_toc() changed to get_toc_val()
    This can get any value from the .toc file such as Interface, Version, X-Website, etc...
  • [!] Merged many addon.php functions ( require_addon, optional_addon, enable_addon, disable_addon ) into one function toggle_addon()
  • [!] Moved addon functions to include/addon_lib.php
  • [!] Moved debug config to the UA settings page
  • [!] Removed all extra ?>
  • [!] Another massive interface overhaul
    Added js styling for overlib
    Finally all html moved into themes and out of php code
    Made the pie charts smaller on the stats page
    Removed uploaded and status idication when no logo's are uploaded
    Added meta tag the prevents IE from showing the image toolbar
  • [!] Moved URL detection to include/uniadmin.php
  • [!] Simplified module detection and inclusion in index.php
  • [!] Changed $uniadmin->debug() to $uniadmin->error()
  • [!] Changed some calls in $uniadmin that used $uniadmin to $this
  • [!] Changed $uniadmin->ls() to be able to not traverse directories if needed
  • [!] Moved interface.php to modules dir, interface.php still exists in the root, but includes index.php and sets $_GET['p'] = 'interface';
  • [!] Changed uniadmin config text strings in locale files
    Using "title|tootip" format now
  • [!] Changed menu generation to give more variables so menu can be styled easily in themes


Beta 0.7.0

  • [~] UA is now mySQL 5 compatible
  • [~] Areas that were not using the dynamic database table names
    Thanks DreadPickle http://www.wowroster.net/Forums/viewtopic/t=260.html
  • [~] Pie charts for php 5.x
  • [~] On logo page, hitting the upload button will not upload a blank logo
  • [~] On addon page, hitting the upload button will not upload a blank addon
  • [~] Uploading addons will now try to chmod and moveuploaded file and report any errors nicely
  • [~] Addons uploaded with an already existing addon in UA will be updated and will not be inserted as a new addon
  • [~] Addon parsing now checks to see if you are uploading a .zip file
  • [~] The temp_anaylize folder will now be on addon processing errors
  • [+] Display templating
  • [+] TOC scanning and display for addons
  • [+] Required/Optional addons selection
    UniUploader 2.5 will give the option to download optional addons
    UniUploader < 2.5 will not even see optional addons
  • [+] required="(0|1)" and toc="0000" to the XML output in interface.php
    UniUploader < 2.5 should ignore this
  • [+] UniAdmin is now fully localized
    English only at this time
  • [+] Database layer code
  • [+] $user object. Holds locale strings, user info, etc...
  • [+] $uniadmin object. Holds UA config info and some common functions
  • [+] UniUploader settings.ini file importing and exporting
  • [!] Help, addons, logo, and settings pages can now be viewed by guests
  • [!] Updated pclzip.lib from v2.3 to v2.5. zip handling should be faster/better
  • [!] Changed initial sql to not set any UU sync settings to enabled
  • [!] Permissions for certain actions have been changed
    Look at the help page for more info
  • [!] Addon parser now uses .toc filename for insertion into the db
  • [!] Addon parser will now reject uploaded addon zip files with no .toc file
  • [!] Revamped look and feel of the interface
  • [!] All pages are now accessed by ?p= GET variable through index.php
    interface.php can still be accessed alone, because UU < v2.5 needs it this way
  • [!] Using POST rather then GET all the buttons (delete, change, modify, etc...)
  • [!] Using error_reporting(E_ALL), removed all php notices
  • [!] Password fields when adding/editing users to actual password fields
  • [!] Addon files table to use addon_id and not addon name
  • [!] Removed all the unused overlib code
  • [!] Updated help page with more info
  • [!] UniUploader related images updated to version 2.5.0
  • [!] All UA configuration has moved to a config page
  • [!] Settings page has been changed
    Each setting now has a specific input type
  • [!] Improved debug to include all SQL queries and page rendertimes
  • [!] Improved messages display
  • [!] Removed even more outdated settings from the db


Beta 0.6.1

  • [~] Support systems with short_open_tags set to Off in the PHP config


Beta 0.6.0

  • [~] Security cookie bug
  • [+] Support for new UU functionality
  • [+] A new setting
  • [+] Overlib tooltips w/pics for each setting
  • [+] view.php unsecure file for viewing addon list


Beta .50

  • [+] Support for UniUploader 2.0, and removed support for previous versions of UU
  • [+] A couple minor things to the help screen.
  • [+] "sv management" to the settings screen
  • [!] Removed a bunch of outdated settings from the db


Beta .40

  • [~] Addon Updater and interface including index.htm and index.html
  • [+] User management
  • [+] setting descriptions
  • [!] bunch of technical changes that nobody cares about (cant remember :P )
  • [!] Cosmetic Changes
  • [!] Deleted obsolete settings from database


Beta .31

  • [~] Default 'PARSEVAR1' in uniadmin.sql.
    This was being set as 'MyProfile' which would break UniUploader Pre-Parse. Corrected to 'myProfile'
  • [!] Updated this install.txt file


The Future?

To-do list for future versions of UA

Personal tools
Namespaces
Variants
Actions
WoWRoster
Preview Roster
Navigation
Toolbox