1 | ////// |
---|
2 | ////// ////// |
---|
3 | ////// liq's feed syndication mod v1.4 |
---|
4 | //////////// |
---|
5 | //////////// |
---|
6 | //////////// |
---|
7 | //////////// |
---|
8 | |
---|
9 | |
---|
10 | |
---|
11 | //INSTALLATION: |
---|
12 | |
---|
13 | ### --> STANDALONE version: |
---|
14 | 1. put all files in your /common directory |
---|
15 | |
---|
16 | 2. add the following line to common/admin_menu.php: |
---|
17 | $menubox->addOption( "Feeds", "?a=admin_feed" ); |
---|
18 | or if you use eve-dev kilboard version 1.2.0 and above (using smarty templates): |
---|
19 | $menubox->addOption("link", "Feeds", "?a=admin_feed"); |
---|
20 | |
---|
21 | 3. wee. youre done. |
---|
22 | |
---|
23 | 4. you can access the feed interface now via the menubox in admin menu |
---|
24 | |
---|
25 | |
---|
26 | ### --> MOD version: |
---|
27 | 1. create directory mods/feed |
---|
28 | |
---|
29 | 2. put the files settings.php and feed_fetcher.php in /mods/feed_syndication directory. |
---|
30 | |
---|
31 | 3. put feed.php in your /common directory |
---|
32 | |
---|
33 | 3. login as admin and enable the feed-mod in 'Mods' |
---|
34 | |
---|
35 | 4. wee. youre done. |
---|
36 | |
---|
37 | 5. click 'Settings' in the 'Mods' menu to access the feed interface |
---|
38 | |
---|
39 | additionally you can add the following line to common/admin_menu.php for direct access: |
---|
40 | $menubox->addOption( "Feeds", "?a=settings_feed" ); |
---|
41 | or if you use eve-dev kilboard version 1.2.0 and above (using smarty templates): |
---|
42 | $menubox->addOption("link", "Feeds", "?a=settings_feed"); |
---|
43 | |
---|
44 | |
---|
45 | |
---|
46 | //FILES: |
---|
47 | |
---|
48 | feed.php <- prints out all kills of the actual week in rss format. |
---|
49 | |
---|
50 | feed_fetcher.php <- contains the actual xml parser class. |
---|
51 | |
---|
52 | admin_feed.php <- is the interface to feed_fetcher.php. lets you define feeds of other killboards and import kills. |
---|
53 | |
---|
54 | |
---|
55 | |
---|
56 | //NOTES: |
---|
57 | |
---|
58 | -> enter feed urls in the format: http://killboard.eve-d2.com/?a=feed |
---|
59 | |
---|
60 | -> a list of known feeds can be found here: http://myeve.eve-online.com/ingameboard.asp?a=topic&threadID=443506&page=1#2 |
---|
61 | |
---|
62 | -> your actual week is automatically selected in the first and last week boxes. |
---|
63 | |
---|
64 | -> clicking the 'fetch' button will by default get all kills of the actual week unless you select a different timeframe. |
---|
65 | |
---|
66 | -> selecting a timeframe with the first and last week boxes lets the fetcher get all mails of this timeframe. |
---|
67 | ** be careful with this option! it can take several minutes or even hours to have all |
---|
68 | the kills parsed and added to your database, especially if you select a really long timeframe ** |
---|
69 | ** be patient. don't close your browser, don't reload. after doing a full fetch first, weekly updates are totally sufficient to keep your board uptodate ** |
---|
70 | |
---|
71 | |
---|
72 | -> by default their kills aka. your losses get fetched unless you tick the 'get kills' |
---|
73 | option in which case their losses aka. your kills get fetched |
---|
74 | |
---|
75 | -> GZip compression is enabled by default because the board automatically |
---|
76 | checks and decides if a fetched stream supports GZip compression - if not it uses regular html/rss output. |
---|
77 | |
---|
78 | |
---|
79 | -> if you are running a master killboard (eg. to supply and share killdata with other killboards) edit settings.php and set 'MASTER' to 1. |
---|
80 | the board will then even fetch kills not related to the alliance or corp ID you set in the killboards config.php. |
---|
81 | leave this option untouched if youre running a normal killboard for your corp or alliance - it will just slow things down and |
---|
82 | wont work for you without modifications to the parser class. |
---|
83 | |
---|
84 | -> the feed is not supposed to be human readable so ffs dont complain about the formatting. |
---|
85 | for human readable rss output use the rss mod ( /?a=rss ) instead. |
---|
86 | |
---|
87 | |
---|
88 | |
---|
89 | //VERSION CHANGES: |
---|
90 | |
---|
91 | |
---|
92 | //v1.4 |
---|
93 | |
---|
94 | feed.php: |
---|
95 | - added selection of the year to output |
---|
96 | - added support for friend<->friend killboard fetching |
---|
97 | - minor code cleanups |
---|
98 | - other stuff i forgot |
---|
99 | |
---|
100 | feed_fetcher.php: |
---|
101 | - added a fix for the memory exhaustion bug some boards had (check if your php is running in php-safe-mode. if so, disable it) |
---|
102 | - improved verbose output |
---|
103 | |
---|
104 | admin_feed.php / settings.php |
---|
105 | - replaced the grab-all switch with an advanced range selection system by week and year |
---|
106 | - added support for friend<->friend killboard fetching |
---|
107 | - minor code cleanups |
---|
108 | - other stuff i forgot |
---|
109 | |
---|
110 | |
---|
111 | //v1.3 |
---|
112 | |
---|
113 | feed.php: |
---|
114 | - added support for GZip compressed output |
---|
115 | - minor code cleanups |
---|
116 | |
---|
117 | feed_fetcher.php: |
---|
118 | - converted to a mod |
---|
119 | - added support for getting GZip compressed feeds and a fallback if the feed is uncompressed |
---|
120 | - changed the text in auto-comment to only show the remote killboards url and not the |
---|
121 | complete path with all passed variables, making it more readable |
---|
122 | |
---|
123 | admin_feed.php / settings.php |
---|
124 | - converted to a mod |
---|
125 | - renamed to settings.php |
---|
126 | - added option to fetch streams with Gzip compression - enabled by default |
---|
127 | - added support for master killboards whose only purpose is to collect and share kill data, see notes |
---|
128 | |
---|
129 | |
---|
130 | //v1.2 |
---|
131 | |
---|
132 | feed.php: |
---|
133 | - added output of feed's version number |
---|
134 | |
---|
135 | feed_fetcher.php: |
---|
136 | - none |
---|
137 | |
---|
138 | admin_feed.php |
---|
139 | - rearranged options to be inline with other admin settings pages |
---|
140 | - added checkboxes to enable / disable fetching specific feed urls |
---|
141 | |
---|
142 | |
---|
143 | //v1.1 |
---|
144 | |
---|
145 | feed.php: |
---|
146 | - now lets you also grab losses, not only kills. |
---|
147 | - will give out only the kills where the request-board-owner (corp or alliance) is victim, |
---|
148 | or in case of losses, the involved. this should speed things up significantly. |
---|
149 | - included a check for Last_Kill_ID so it starts to output kill data only after |
---|
150 | that ID to remove redundancy when fetching a feed more than once. |
---|
151 | |
---|
152 | feed_fetcher.php: |
---|
153 | - included getConfig and setConfig call functions to guarantee backwards compatiblity with older killboard version that miss those functions. |
---|
154 | - included calls to the killboards comment function so you can add predefined comments to autoparsed kills aka. "post your losses noob". |
---|
155 | |
---|
156 | admin_feed.php: |
---|
157 | - made the number of feeds user selectable |
---|
158 | - more detailed descriptions |
---|
159 | - option for verbose mode (lets you show/hide errormessages from imported killmails) |
---|
160 | - option to automatically enter a comment with the autoparsed kill |
---|
161 | - option to get kills instead of losses |
---|
162 | - added backwards compatibility to exi's v1.0 mod |
---|
163 | |
---|
164 | |
---|
165 | |
---|
166 | cheers |
---|
167 | //liquidism |
---|