]>
Commit | Line | Data |
---|---|---|
cd5327be V |
1 | <?php |
2 | ||
349b0144 V |
3 | namespace Shaarli\Netscape; |
4 | ||
5 | use DateTime; | |
6 | use DateTimeZone; | |
7 | use Exception; | |
dea72c71 | 8 | use Katzgrau\KLogger\Logger; |
48417aed | 9 | use Psr\Log\LogLevel; |
cf92b4dd A |
10 | use Shaarli\Bookmark\Bookmark; |
11 | use Shaarli\Bookmark\BookmarkServiceInterface; | |
87e9631e | 12 | use Shaarli\Config\ConfigManager; |
cf92b4dd | 13 | use Shaarli\Formatter\BookmarkFormatter; |
bdc5152d | 14 | use Shaarli\History; |
48417aed | 15 | use Shaarli\NetscapeBookmarkParser\NetscapeBookmarkParser; |
48417aed | 16 | |
cd5327be V |
17 | /** |
18 | * Utilities to import and export bookmarks using the Netscape format | |
48417aed | 19 | * TODO: Not static, use a container. |
cd5327be V |
20 | */ |
21 | class NetscapeBookmarkUtils | |
22 | { | |
23 | ||
24 | /** | |
cf92b4dd | 25 | * Filters bookmarks and adds Netscape-formatted fields |
cd5327be V |
26 | * |
27 | * Added fields: | |
28 | * - timestamp link addition date, using the Unix epoch format | |
29 | * - taglist comma-separated tag list | |
30 | * | |
cf92b4dd A |
31 | * @param BookmarkServiceInterface $bookmarkService Link datastore |
32 | * @param BookmarkFormatter $formatter instance | |
33 | * @param string $selection Which bookmarks to export: (all|private|public) | |
34 | * @param bool $prependNoteUrl Prepend note permalinks with the server's URL | |
35 | * @param string $indexUrl Absolute URL of the Shaarli index page | |
cd5327be | 36 | * |
cf92b4dd A |
37 | * @return array The bookmarks to be exported, with additional fields |
38 | *@throws Exception Invalid export selection | |
cd5327be | 39 | * |
cd5327be | 40 | */ |
cf92b4dd A |
41 | public static function filterAndFormat( |
42 | $bookmarkService, | |
43 | $formatter, | |
44 | $selection, | |
45 | $prependNoteUrl, | |
46 | $indexUrl | |
47 | ) { | |
cd5327be | 48 | // see tpl/export.html for possible values |
349b0144 V |
49 | if (!in_array($selection, array('all', 'public', 'private'))) { |
50 | throw new Exception(t('Invalid export selection:') . ' "' . $selection . '"'); | |
cd5327be V |
51 | } |
52 | ||
53 | $bookmarkLinks = array(); | |
cf92b4dd A |
54 | foreach ($bookmarkService->search([], $selection) as $bookmark) { |
55 | $link = $formatter->format($bookmark); | |
56 | $link['taglist'] = implode(',', $bookmark->getTags()); | |
57 | if ($bookmark->isNote() && $prependNoteUrl) { | |
bb4a23aa V |
58 | $link['url'] = $indexUrl . $link['url']; |
59 | } | |
60 | ||
cd5327be V |
61 | $bookmarkLinks[] = $link; |
62 | } | |
63 | ||
64 | return $bookmarkLinks; | |
65 | } | |
a973afea V |
66 | |
67 | /** | |
68 | * Generates an import status summary | |
69 | * | |
70 | * @param string $filename name of the file to import | |
71 | * @param int $filesize size of the file to import | |
cf92b4dd A |
72 | * @param int $importCount how many bookmarks were imported |
73 | * @param int $overwriteCount how many bookmarks were overwritten | |
74 | * @param int $skipCount how many bookmarks were skipped | |
66e74d50 | 75 | * @param int $duration how many seconds did the import take |
a973afea V |
76 | * |
77 | * @return string Summary of the bookmark import status | |
78 | */ | |
79 | private static function importStatus( | |
80 | $filename, | |
81 | $filesize, | |
f211e417 V |
82 | $importCount = 0, |
83 | $overwriteCount = 0, | |
84 | $skipCount = 0, | |
85 | $duration = 0 | |
86 | ) { | |
12266213 | 87 | $status = sprintf(t('File %s (%d bytes) '), $filename, $filesize); |
a973afea | 88 | if ($importCount == 0 && $overwriteCount == 0 && $skipCount == 0) { |
12266213 | 89 | $status .= t('has an unknown file format. Nothing was imported.'); |
a973afea | 90 | } else { |
12266213 | 91 | $status .= vsprintf( |
9d9f6d75 V |
92 | t( |
93 | 'was successfully processed in %d seconds: ' | |
cf92b4dd | 94 | . '%d bookmarks imported, %d bookmarks overwritten, %d bookmarks skipped.' |
9d9f6d75 | 95 | ), |
12266213 A |
96 | [$duration, $importCount, $overwriteCount, $skipCount] |
97 | ); | |
a973afea V |
98 | } |
99 | return $status; | |
100 | } | |
101 | ||
102 | /** | |
103 | * Imports Web bookmarks from an uploaded Netscape bookmark dump | |
104 | * | |
cf92b4dd A |
105 | * @param array $post Server $_POST parameters |
106 | * @param array $files Server $_FILES parameters | |
107 | * @param BookmarkServiceInterface $bookmarkService Loaded LinkDB instance | |
108 | * @param ConfigManager $conf instance | |
109 | * @param History $history History instance | |
a973afea V |
110 | * |
111 | * @return string Summary of the bookmark import status | |
112 | */ | |
cf92b4dd | 113 | public static function import($post, $files, $bookmarkService, $conf, $history) |
a973afea | 114 | { |
66e74d50 | 115 | $start = time(); |
a973afea V |
116 | $filename = $files['filetoupload']['name']; |
117 | $filesize = $files['filetoupload']['size']; | |
118 | $data = file_get_contents($files['filetoupload']['tmp_name']); | |
119 | ||
3ff1ce47 | 120 | if (preg_match('/<!DOCTYPE NETSCAPE-Bookmark-file-1>/i', $data) === 0) { |
a973afea V |
121 | return self::importStatus($filename, $filesize); |
122 | } | |
123 | ||
cf92b4dd | 124 | // Overwrite existing bookmarks? |
349b0144 | 125 | $overwrite = !empty($post['overwrite']); |
a973afea | 126 | |
cf92b4dd | 127 | // Add tags to all imported bookmarks? |
a973afea V |
128 | if (empty($post['default_tags'])) { |
129 | $defaultTags = array(); | |
130 | } else { | |
131 | $defaultTags = preg_split( | |
132 | '/[\s,]+/', | |
133 | escape($post['default_tags']) | |
134 | ); | |
135 | } | |
136 | ||
cf92b4dd | 137 | // bookmarks are imported as public by default |
a973afea V |
138 | $defaultPrivacy = 0; |
139 | ||
140 | $parser = new NetscapeBookmarkParser( | |
48417aed A |
141 | true, // nested tag support |
142 | $defaultTags, // additional user-specified tags | |
143 | strval(1 - $defaultPrivacy), // defaultPub = 1 - defaultPrivacy | |
144 | $conf->get('resource.data_dir') // log path, will be overridden | |
145 | ); | |
146 | $logger = new Logger( | |
147 | $conf->get('resource.data_dir'), | |
349b0144 | 148 | !$conf->get('dev.debug') ? LogLevel::INFO : LogLevel::DEBUG, |
48417aed A |
149 | [ |
150 | 'prefix' => 'import.', | |
151 | 'extension' => 'log', | |
152 | ] | |
a973afea | 153 | ); |
48417aed | 154 | $parser->setLogger($logger); |
a973afea V |
155 | $bookmarks = $parser->parseString($data); |
156 | ||
157 | $importCount = 0; | |
158 | $overwriteCount = 0; | |
159 | $skipCount = 0; | |
160 | ||
161 | foreach ($bookmarks as $bkm) { | |
162 | $private = $defaultPrivacy; | |
163 | if (empty($post['privacy']) || $post['privacy'] == 'default') { | |
164 | // use value from the imported file | |
165 | $private = $bkm['pub'] == '1' ? 0 : 1; | |
d2d4f993 | 166 | } elseif ($post['privacy'] == 'private') { |
cf92b4dd | 167 | // all imported bookmarks are private |
a973afea | 168 | $private = 1; |
d2d4f993 | 169 | } elseif ($post['privacy'] == 'public') { |
cf92b4dd | 170 | // all imported bookmarks are public |
a973afea | 171 | $private = 0; |
3ff1ce47 | 172 | } |
a973afea | 173 | |
cf92b4dd A |
174 | $link = $bookmarkService->findByUrl($bkm['uri']); |
175 | $existingLink = $link !== null; | |
176 | if (! $existingLink) { | |
177 | $link = new Bookmark(); | |
178 | } | |
a973afea V |
179 | |
180 | if ($existingLink !== false) { | |
181 | if ($overwrite === false) { | |
182 | // Do not overwrite an existing link | |
183 | $skipCount++; | |
184 | continue; | |
185 | } | |
186 | ||
cf92b4dd | 187 | $link->setUpdated(new DateTime()); |
a973afea | 188 | $overwriteCount++; |
cf92b4dd A |
189 | } else { |
190 | $newLinkDate = new DateTime('@' . strval($bkm['time'])); | |
191 | $newLinkDate->setTimezone(new DateTimeZone(date_default_timezone_get())); | |
192 | $link->setCreated($newLinkDate); | |
a973afea V |
193 | } |
194 | ||
cf92b4dd A |
195 | $link->setTitle($bkm['title']); |
196 | $link->setUrl($bkm['uri'], $conf->get('security.allowed_protocols')); | |
197 | $link->setDescription($bkm['note']); | |
198 | $link->setPrivate($private); | |
199 | $link->setTagsString($bkm['tags']); | |
200 | ||
201 | $bookmarkService->addOrSet($link, false); | |
a973afea V |
202 | $importCount++; |
203 | } | |
204 | ||
cf92b4dd | 205 | $bookmarkService->save(); |
66e74d50 A |
206 | $history->importLinks(); |
207 | ||
208 | $duration = time() - $start; | |
a973afea V |
209 | return self::importStatus( |
210 | $filename, | |
211 | $filesize, | |
212 | $importCount, | |
213 | $overwriteCount, | |
66e74d50 A |
214 | $skipCount, |
215 | $duration | |
a973afea V |
216 | ); |
217 | } | |
cd5327be | 218 | } |